Siga as etapas deste guia de início rápido. Em cerca de 10 minutos, você um aplicativo de linha de comando Python simples que faz solicitações para os registros sem toque a API de registro do revendedor.
Pré-requisitos
Para executar este guia de início rápido, você precisa do seguinte:
- Uma Conta do Google, que seja membro do seu revendedor de registro sem toque do Compute Engine. Se você ainda não fez a integração, siga as etapas em Começar no guia do Portal do revendedor.
- Python 2.6 ou superior.
- Gerenciamento de pacotes PIP .
- Acesso à Internet e a um navegador da Web.
Etapa 1: ativar a API de registro sem toque
- Use este assistente para criar ou selecionar um projeto no Google Developers Console e ativar a API automaticamente. Clique em Continuar e em Acessar credenciais
- Defina Quais dados você acessará? como Dados do aplicativo.
- Clique em Próxima. Você vai receber uma solicitação para criar um serviço do Compute Engine.
- Dê um nome descritivo para o Nome da conta de serviço.
- Anote o ID da conta de serviço (parece um endereço de e-mail) porque você usá-lo mais tarde.
- Defina o Papel como Contas de serviço > Usuário da conta de serviço.
- Clique em Concluído para terminar a criação da conta de serviço.
- Clique no endereço de e-mail da conta de serviço que você criou.
- Clique em **Chaves**.
- Clique em **Adicionar chave** e depois em **Criar nova chave**.
- Em **Tipo de chave**, selecione **JSON**.
- Clique em Criar. O download da chave privada é feito no computador.
- Clique em **Fechar**.
- Mova o arquivo para o diretório de trabalho e renomeie-o como
service_account_key.json
.
Etapa 2: vincular a conta de serviço
- Abra o portal do registro sem toque. Talvez seja necessário fazer login.
- Clique em Serviço contas.
- Clique em Vincular conta de serviço.
- Defina Endereço de e-mail como o endereço da conta de serviço que você criou.
- Clique em Vincular conta de serviço para usá-la com o registro sem toque. conta de registro.
Etapa 3: instalar a biblioteca de cliente do Google
Execute o seguinte comando para instalar a biblioteca usando o pip:
pip install --upgrade google-api-python-client
Consulte as instruções de instalação da biblioteca página de configuração .
Etapa 4: configurar a amostra
Crie um arquivo chamado quickstart.py
no seu diretório de trabalho. Copie no
código a seguir e salve o arquivo. Insira seu próprio parceiro revendedor
ID como o valor de PARTNER_ID
(a primeira linha do app após o
importações).
#!/usr/bin/env python # -*- coding: utf-8 -*- """Zero-touch enrollment reseller quickstart. This script forms the quickstart introduction to the zero-touch enrollemnt reseller API. To learn more, visit https://developer.google.com/zero-touch """ from apiclient.discovery import build from httplib2 import Http from oauth2client.service_account import ServiceAccountCredentials # TODO: replace this with your partner reseller ID. PARTNER_ID = '11036885'; # A single auth scope is used for the zero-touch enrollment customer API. SCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning'] SERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json' def get_credential(): """Creates a Credential object with the correct OAuth2 authorization. Creates a Credential object with the correct OAuth2 authorization for the service account that calls the reseller API. The service endpoint calls this method when setting up a new service instance. Returns: Credential, the user's credential. """ credential = ServiceAccountCredentials.from_json_keyfile_name( SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES) return credential def get_service(): """Creates a service endpoint for the zero-touch enrollment reseller API. Builds and returns an authorized API client service for v1 of the API. Use the service endpoint to call the API methods. Returns: A service Resource object with methods for interacting with the service. """ http_auth = get_credential().authorize(Http()) service = build('androiddeviceprovisioning', 'v1', http=http_auth) return service def main(): """Runs the zero-touch enrollment quickstart app. """ # Create a zero-touch enrollment API service endpoint. service = get_service() # Send an API request to list all our customers. response = service.partners().customers().list(partnerId=PARTNER_ID).execute() # Print out the details of each customer. if 'customers' in response: for customer in response['customers']: print 'Name:{0} ID:{1}'.format( customer['companyName'], customer['companyId']) else: print 'No customers found' if __name__ == '__main__': main()
ID do parceiro
As chamadas de API geralmente precisam do ID do parceiro revendedor como argumento. Para encontrar seu ID do parceiro no portal de registro sem toque, siga as etapas abaixo:
- Abra o portal. Talvez seja necessário fazer login.
- Clique em Serviço contas.
- Copie o número do ID do parceiro na linha Seu ID de revendedor.
Etapa 5: executar a amostra
Use a ajuda do seu sistema operacional para executar o script no arquivo. Em UNIX e Mac computadores, execute o comando abaixo no seu terminal:
python quickstart.py
Respostas da API Printing
Para facilitar a inspeção de respostas ao testar a API, formate o dados de resposta a incidentes. O snippet abaixo mostra como você pode fazer isso em Python usando o Módulo JSON:
from json import dumps
# ...
results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,
body={'claims':new_claims}).execute()
# Print formatted JSON response
print dumps(results, indent=4, sort_keys=True)
Solução de problemas
Conte-nos o que deu errado com o guia de início rápido, e nós trabalharemos para resolver corrigi-lo. Para saber como o registro sem toque usa contas de serviço para autorizar chamadas de API, leia Autorização.