Modify a Project

  • Device Access Projects can be modified, including project name, OAuth Client ID, and event settings, through the Device Access Console.

  • Changing the OAuth Client ID will deauthorize existing access tokens, requiring new ones to be generated.

  • Projects can be configured to enable events, providing a Pub/Sub topic for receiving device-related data.

  • Developers interested in commercial partnerships can apply for review through the Device Access Console.

A Device Access Project can be modified through the Device Access Console.

Go to the Device Access Console

Select an existing project from the home screen to enter the project's information screen.

Modify the project name

Device Access project name

A project name can be changed at any time. The name must be 1-25 characters, including spaces.

  1. Click the icon to the right of the current project name at the top.
  2. Modify the project name and click Save when you're finished.

Modify the OAuth Client ID

The OAuth Client ID associated with your project can be changed at any time. Remember that an OAuth Client ID must be valid and unique to a project, and cannot be shared with other projects.

Take caution when changing your client ID. If you do so, any existing access tokens associated with the previous client ID will be deauthorized and any subsequent API calls made with those tokens will fail.

  1. Click the icon for OAuth client ID and select Edit.
  2. Update the client ID and click Save.

See Set up Google Cloud Platform for instructions on how to obtain a Client ID.

Enable events

If you've already enabled events (for example, during project creation), the Pub/Sub topic field in the Enable Pubsub topic for Events section should already have a value, called a Topic ID, in the older format of:

projects/sdm-prod/topics/enterprise-project-id

To migrate from a Google-hosted topic, disable the Google-hosted Pub/Sub topic in the Device Access Console and re-enable events using a self-hosted Pub/Sub topic created in your own Google Cloud project. Migrating your Pub/Sub topic configuration does not invalidate existing user access tokens or OAuth permissions.

Self-hosted Pub/Sub topics can be created or changed in your own Google Cloud project and are subject to standard Google Cloud Pub/Sub pricing (which includes a free tier of 10 GB per month).

Create the Pub/Sub topic:

gcloud pubsub topics create {topic} --message-retention-duration=0s

Grant the necessary SDM API permissions to access and publish event data for your project's Topic ID:

gcloud pubsub topics add-iam-policy-binding projects/{project}/topics/{topic} \
--member="group:sdm-publisher@googlegroups.com" \
--role="roles/pubsub.publisher"

The format of your newly created Topic ID will look like:

projects/gcp-project-name/subscriptions/topic-id

Take note of your Topic ID, you'll need it to complete enabling events. See Create a topic for further information.

To enable events (or migrate from a Google-hosted topic):

  1. If creating a new project, select Enable events and click Create Project. If migrating an existing project from a Google-hosted topic, first disable the existing Pub/Sub topic in the project's information screen.
  2. Click the icon for Pub/Sub topic and select Enable events with PubSub topic (or Edit current topic).
  3. Enter the self-hosted Pub/Sub Topic ID that you created earlier.

Copy your Topic ID, you'll need it to create a subscription to the topic so event messages can be retrieved. For more information, see Events.