Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O Device Access programa permite que os usuários acessem, controlem e gerenciem
dispositivos Google Nest usando a API SDM.
Para começar a usar o Device Access, você precisa concluir as seguintes tarefas:
Inscreva-se no Device Access programa.
Ative um dispositivo Nest compatível com uma Conta do Google.
Crie um projeto do Google Cloud para ativar a API SDM e receber um ID do cliente OAuth 2.0.
Crie um Device Access projeto para receber um ID de projeto.
Registrar o acesso ao dispositivo
Antes de criar seu primeiro projeto, você precisa se inscrever no Device Access.
O registro consiste na aceitação dos Termos de Serviço da API Google e do Sandbox de acesso ao dispositivo, além de uma taxa única não reembolsável (US$5) por conta.
Não será possível criar um projeto até que você aceite os Termos de Serviço e pague a taxa de registro. Isso se aplica a todos os usuários, tanto individuais quanto aqueles que querem criar uma oferta
comercial.
Faça o registro no Device Access Console, se ainda não tiver feito isso:
Os seguintes dispositivos são compatíveis com o programa Device Access :
Todos os termostatos Google Nest
Todas as câmeras Google Nest
Todas as Google Nest Doorbells
Google Nest Hub Max
Consulte a página Dispositivos compatíveis para ver uma
lista de modelos de dispositivos individuais.
Consulte os manuais do dispositivo para saber como ativar o dispositivo compatível.
Configurar o Google Cloud Platform
O acesso à API SDM é fornecido pelo
Google Cloud. Para ativar a API e autorizar uma Conta do Google com
um dispositivo Nest compatível, você vai precisar de um projeto do Google Cloud.
Use o botão Ativar a API e receber um ID do cliente OAuth 2.0 abaixo para ativar
a API Smart Device Management e receber um ID do cliente OAuth 2.0:
Se você tiver um projeto do Google Cloud que gostaria de usar para Device Access, faça login na conta de administrador desse projeto primeiro. Em seguida, selecione o projeto na lista de
projetos disponíveis depois de clicar no botão. Caso contrário, crie um
novo projeto.
Selecione Servidor da Web quando a pergunta "De onde você está ligando?" for feita.
Insira https://www.google.com como o valor para URIs de redirecionamento
autorizados. Um URI de redirecionamento é necessário para receber um código de autorização usando
o PCM.
Depois que a configuração for concluída, copie os valores do ID do cliente e da chave secreta do cliente OAuth 2.0
e faça o download do JSON de credenciais na sua máquina local.
Se você quiser configurar manualmente seu projeto do Google Cloud ou verificar
a configuração e recuperar suas credenciais novamente:
Ative a API Smart Device Management na página
Ativação de API.
Receba um ID do cliente OAuth 2.0 na página
Credenciais.
Criar um projeto de acesso a dispositivos
Volte ao Device Access console.
Na tela inicial do console, selecione
add_circle_outline Criar
projeto.
Preencha cada tela no processo de criação:
Insira um nome para seu projeto.
Insira o ID do cliente OAuth 2.0 gerado durante a
Configuração do Google Cloud Platform. Se você
não tiver copiado o ID do cliente OAuth antes, ele estará no
arquivo credentials.json que você fez o download.
Ativar ou desativar eventos. Os eventos são gerenciados pelo Google Cloud Pub/Sub
e fornecem atualizações assíncronas para todos os dispositivos e estruturas
autorizados para seu projeto. Se você quiser eventos, selecione
Ativar eventos, Criar projeto, edite o tópico do Pub/Sub
e informe um ID de tópico. Se não tiver certeza, selecione Desativar.
É possível reativá-los mais tarde.
Após a conclusão, um ID de projeto é atribuído ao seu projeto, na forma de um
UUID, como 32c4c2bc-fe0d-461b-b51c-f3885afff2f0. Anote esse ID,
ele é necessário para todas as chamadas da API SDM.
Esse ID do projeto é usado em chamadas de OAuth e API. Ele é específico do seu projetoDevice Access e não está relacionado a um ID de projeto do Google Cloud.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-06-03 UTC."],[[["\u003cp\u003eThe Device Access program enables users to access and manage Google Nest devices via the SDM API.\u003c/p\u003e\n"],["\u003cp\u003eTo utilize Device Access, users must register for the program, activate a supported Nest device with a Google account, and set up a Google Cloud project for API access.\u003c/p\u003e\n"],["\u003cp\u003eA Device Access project needs to be created, requiring a unique Project ID for all SDM API calls, and users must use a consumer Google Account for registration.\u003c/p\u003e\n"],["\u003cp\u003eSupported devices include all Google Nest Thermostats, Cameras, Doorbells, and Google Nest Hub Max.\u003c/p\u003e\n"]]],[],null,["# Get Started\n\nThe Device Access program allows users to access, control, and manage\nGoogle Nest devices using the SDM API.\n\nTo get started with Device Access, you need to complete the following tasks:\n\n1. Register for the Device Access program.\n2. Activate a supported Nest device with a Google account.\n3. Create a Google Cloud project to enable the SDM API and get an OAuth 2.0 client ID.\n4. Create a Device Access project to receive a Project ID.\n\nRegister for Device Access\n--------------------------\n\nBefore creating your first project, you must register for Device Access.\nRegistration consists of the acceptance of the [Google API](/terms) and [Device\nAccess Sandbox](/nest/device-access/tos) Terms of Service, along with a one-time,\nnon-refundable fee (US$5) per account.\n\nYou will not be able to create a project until you have accepted both Terms of\nService and paid the registration fee. This applies to all users, both\nindividual users and those looking to create a commercial\noffering.\n\nRegister in the Device Access Console, if you haven't already:\n\n[Go to the Device Access Console](https://console.nest.google.com/device-access)\n| **Warning:** You must use a [consumer Google Account](https://support.google.com/work/android/answer/6371476) (for example, a gmail.com account) to register for Device Access. You cannot use a Google Workspace account. If you work for an organization, we suggest registering for Device Access using an account for your team.\n| **Warning:** Once a Google Account is associated with your Device Access Project **it cannot be changed**, be sure you are signed into the correct Google Account before continuing.\n\nSee [Device Access Registration](/nest/device-access/registration) for more\ninformation.\n\nActivate a supported device\n---------------------------\n\nThe following devices are supported in the Device Access program:\n\n- All Google Nest Thermostats\n- All Google Nest Cameras\n- All Google Nest Doorbells\n- Google Nest Hub Max\n\nSee the [Supported Devices](/nest/device-access/supported-devices) page for a\nlisting of individual device models.\n| **Note:** A supported device must be activated with a Google account. Legacy Nest accounts are **not** supported for Device Access. See the [FAQs\n| about accounts for the Nest app](https://support.google.com/googlenest/answer/9297676) for more information on migrating a legacy Nest account.\n\nSee the device manuals for information on how to activate your supported device.\n\nSet up Google Cloud Platform\n----------------------------\n\nAccess to the SDM API is provided through\nGoogle Cloud. To enable the API and authorize a Google account with\na supported Nest device, you'll need a Google Cloud\nproject.\n\nUse the **Enable the API and get an OAuth 2.0 Client ID** button below to enable\nthe **Smart Device Management API** and get an OAuth 2.0 Client ID:\n\n1. If you have an existing Google Cloud project that you would like to use for Device Access, make sure you are logged into the admin account for that project first. Then select the existing project from the list of available projects after clicking the button. Otherwise, create a new project.\n2. Select **Web Server** when it asks \"Where are you calling from?\".\n3. Enter *https://www.google.com* as the value for **Authorized redirect\n URIs**. A redirect URI is required to obtain an Authorization Code using PCM.\n4. Once setup is complete, **copy the OAuth 2.0 Client ID and Client Secret\n values, and download the Credentials JSON to your local machine**.\n\nEnable the API and get an OAuth 2.0 Client ID\n\nIf you want to manually set up your Google Cloud project, or verify\nthe setup and retrieve your credentials again:\n\n1. Enable **Smart Device Management API** on the [API Enablement](https://console.developers.google.com/apis/library/smartdevicemanagement.googleapis.com) page.\n2. Get an OAuth 2.0 Client ID on the [Credentials](https://console.developers.google.com/apis/credentials) page.\n\nCreate a Device Access project\n------------------------------\n\nReturn to the Device Access Console.\n\n1. At the Console home screen, select **add_circle_outline Create\n project**.\n2. Fill out each screen in the creation process:\n 1. Enter a name for your project.\n 2. Enter the OAuth 2.0 Client ID generated during [Set up Google Cloud Platform](#set_up_google_cloud_platform). If you didn't copy your OAuth Client ID earlier, you can find it in the `credentials.json` file you downloaded. **Note:** To use a project with the SDM API:\n | - You must specify a valid OAuth Client ID for the project.\n | - An OAuth Client ID must be valid and unique to a project, and cannot be shared with other projects.\n 3. Enable or disable events. Events are managed by Google Cloud Pub/Sub and provide asynchronous updates for all devices and structures authorized for your project. If you want events, select **Enable events** , then **Create Project** , and then edit the Pub/Sub topic and provide a Topic ID. If you're not sure, select **Disable**. They can always be enabled later.\n3. Upon completion, your project is assigned a Project ID, in the form of a UUID, such as `32c4c2bc-fe0d-461b-b51c-f3885afff2f0`. Make note of this ID, you need it for all SDM API calls.\n\nThis Project ID is used in OAuth and API calls. It is specific to your\nDevice Access project, and is not related to a Google Cloud\nProject ID."]]
