Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Folgen Sie der Anleitung in dieser Kurzanleitung. In etwa 10 Minuten haben Sie eine einfache Python-Befehlszeilen-App, die Anfragen an die Reseller API für die Zero-Touch-Registrierung sendet.
Vorbereitung
Für diese Kurzanleitung benötigen Sie Folgendes:
Ein Google-Konto, das Mitglied Ihres Reseller-Kontos für die Zero-Touch-Registrierung ist. Wenn Sie noch nicht eingerichtet sind, folgen Sie der Anleitung unter Erste Schritte im Leitfaden für das Reseller-Portal.
Verwenden Sie diesen Assistenten, um in der Google Developers Console ein Projekt zu erstellen oder auszuwählen und die API automatisch zu aktivieren. Klicken Sie auf Weiter und dann auf Zu den Anmeldedaten.
Wählen Sie unter Auf welche Daten wird zugegriffen? die Option Anwendungsdaten aus.
Klicken Sie auf Weiter. Sie werden aufgefordert, ein Dienstkonto zu erstellen.
Geben Sie für Name des Dienstkontos einen aussagekräftigen Namen ein.
Notieren Sie sich die Dienstkonto-ID (sie sieht aus wie eine E-Mail-Adresse), da Sie sie später benötigen.
Legen Sie für Rolle die Option Dienstkonten > Dienstkontonutzer fest.
Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.
Klicken Sie auf die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
Klicken Sie auf **Schlüssel**.
Klicken Sie auf „Schlüssel hinzufügen“ und dann auf „Neuen Schlüssel erstellen“.
Wählen Sie als **Schlüsseltyp** die Option **JSON** aus.
Klicken Sie auf Erstellen. Der private Schlüssel wird auf Ihren Computer heruntergeladen.
Klicken Sie auf **Schließen**.
Verschieben Sie die Datei in Ihr Arbeitsverzeichnis und benennen Sie sie in service_account_key.json um.
Geben Sie unter E-Mail-Adresse die Adresse des von Ihnen erstellten Dienstkontos ein.
Klicken Sie auf Dienstkonto verknüpfen, um das Dienstkonto mit Ihrem Zero-Touch-Registrierungskonto zu verwenden.
Schritt 3: Google-Clientbibliothek installieren
Führen Sie den folgenden Befehl aus, um die Bibliothek mit pip zu installieren:
pipinstall--upgradegoogle-api-python-client
Auf der Installationsseite der Bibliothek finden Sie verschiedene Installationsoptionen.
Schritt 4: Beispiel einrichten
Erstellen Sie in Ihrem Arbeitsverzeichnis eine Datei mit dem Namen quickstart.py. Kopieren Sie den folgenden Code und speichern Sie die Datei. Fügen Sie Ihre eigene Reseller-Partner-ID als Wert für PARTNER_ID ein (erste Zeile der App nach den Importen).
#!/usr/bin/env python# -*- coding: utf-8 -*-"""Zero-touch enrollment reseller quickstart.This script forms the quickstart introduction to the zero-touch enrollemntreseller API. To learn more, visit https://developer.google.com/zero-touch"""fromapiclient.discoveryimportbuildfromhttplib2importHttpfromoauth2client.service_accountimportServiceAccountCredentials# 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'defget_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)returncredentialdefget_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)returnservicedefmain():"""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'inresponse:forcustomerinresponse['customers']:print'Name:{0} ID:{1}'.format(customer['companyName'],customer['companyId'])else:print'No customers found'if__name__=='__main__':main()
Partner-ID
Für API-Aufrufe ist in der Regel Ihre Reseller-Partner-ID als Argument erforderlich. So finden Sie Ihre Partner-ID im Zero-Touch-Registrierungsportal:
Öffnen Sie das Portal. Eventuell musst du dich anmelden.
Klicken Sie auf settings_ethernetDienstkonten.
Kopieren Sie Ihre Partner-ID aus der Zeile Ihre Reseller-ID.
Schritt 5: Beispiel ausführen
Lesen Sie in der Hilfe Ihres Betriebssystems nach, wie Sie das Script in der Datei ausführen. Führen Sie auf UNIX- und Mac-Computern den folgenden Befehl im Terminal aus:
pythonquickstart.py
API-Antworten drucken
Formatieren Sie die JSON-Antwortdaten, damit Sie die Antworten beim Testen der API leichter prüfen können. Im folgenden Snippet wird gezeigt, wie Sie dies in Python mit dem JSON-Modul tun können:
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Benötigte Informationen nicht gefunden","missingTheInformationINeed","thumb-down"],["Zu umständlich/zu viele Schritte","tooComplicatedTooManySteps","thumb-down"],["Nicht mehr aktuell","outOfDate","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Problem mit Beispielen/Code","samplesCodeIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-08-29 (UTC)."],[[["\u003cp\u003eThis quickstart guide helps you set up a Python command-line app to interact with the zero-touch enrollment reseller API in about 10 minutes.\u003c/p\u003e\n"],["\u003cp\u003ePrerequisites include having a Google account, Python 2.6 or greater, the pip package management tool, and internet access.\u003c/p\u003e\n"],["\u003cp\u003eThe setup involves creating and enabling a service account in the Google Developers Console, linking it in the zero-touch enrollment portal, and downloading its JSON key file.\u003c/p\u003e\n"],["\u003cp\u003eYou will need to install the Google client library using pip, and then create and modify the \u003ccode\u003equickstart.py\u003c/code\u003e file with your reseller partner ID to run a sample API request.\u003c/p\u003e\n"],["\u003cp\u003eThe guide provides instructions for finding your partner ID, running the Python script, and formatting JSON responses for easier inspection.\u003c/p\u003e\n"]]],["First, enable the zero-touch enrollment API by creating a service account, setting its role, and downloading its JSON key. Next, link this service account in the zero-touch enrollment portal using the service account's email address. Install the Google client library with `pip`. Then, create a `quickstart.py` file, inserting your reseller partner ID, and run it via the terminal to make an API request, listing customer details. Retrieve partner ID from the Service Accounts page in the portal.\n"],null,["# Python quickstart for resellers\n\nFollow the steps in this quickstart guide, and in about 10 minutes you'll have\na simple Python command-line app that makes requests to the zero-touch\nenrollment reseller API.\n\nPrerequisites\n-------------\n\nTo run this quickstart, you'll need:\n\n- A Google account, that's a member of your zero-touch enrollment reseller account. If you haven't onboarded yet, follow the steps in *Get started* in the [Reseller portal guide](/zero-touch/guides/portal).\n- Python 2.6 or greater.\n- The [pip](https://pypi.python.org/pypi/pip) package management tool.\n- Access to the internet and a web browser.\n\nStep 1: Turn on the zero-touch enrollment API\n---------------------------------------------\n\n1. Use [this\n wizard](https://console.developers.google.com/start/api?id=androiddeviceprovisioning.googleapis.com) to create or select a project in the Google Developers Console and automatically turn on the API. Click **Continue** , then **Go to credentials**.\n2. Set **What data will you be accessing?** to *Application data*.\n3. Click **Next**. You should be prompted to create a service account.\n4. Give a descriptive name for **Service account name**.\n5. Note the **Service account ID** (it looks like an email address) because you'll use it later.\n6. Set **Role** to *Service Accounts \\\u003e Service Account User*.\n7. Click **Done** to finish creating the service account.\n8. Click the email address for the service account that you created.\n9. Click \\*\\*Keys\\*\\*.\n10. Click \\*\\*Add key\\*\\*, then click \\*\\*Create new key\\*\\*.\n11. For \\*\\*Key type\\*\\*, select \\*\\*JSON\\*\\*.\n12. Click **Create** and the private key downloads to your computer.\n13. Click \\*\\*Close\\*\\*.\n14. Move the file to your working directory and rename it `service_account_key.json`.\n\n| **Warning:** Service account keys can become a security risk if not managed carefully. For advice see [best practices for managing API keys](https://cloud.google.com/iam/docs/best-practices-for-managing-service-account-keys).\n\nStep 2: Link the service account\n--------------------------------\n\n1. Open the zero-touch enrollment [portal](https://enterprise.google.com/android/zero-touch/resellers). You might need to sign in.\n2. Click settings_ethernet **Service\n accounts**.\n3. Click add **Link service account**.\n4. Set **Email address** to the address of the service account you created.\n5. Click **Link service account** to use the service account with your zero-touch enrollment account.\n\nStep 3: Install the Google client library\n-----------------------------------------\n\nRun the following command to install the library using pip: \n\n pip install --upgrade google-api-python-client\n\nSee the library's [installation\npage](/api-client-library/python/start/installation) for different installation\noptions.\n\nStep 4: Set up the sample\n-------------------------\n\nCreate a file named `quickstart.py` in your working directory. Copy in the\nfollowing code and save the file. Insert your own [reseller partner\nID](#partner-id) as the value for `PARTNER_ID` (the app's first line after the\nimports). \n\n```python\n#!/usr/bin/env python\n# -*- coding: utf-8 -*-\n\"\"\"Zero-touch enrollment reseller quickstart.\n\nThis script forms the quickstart introduction to the zero-touch enrollemnt\nreseller API. To learn more, visit https://developer.google.com/zero-touch\n\"\"\"\n\nfrom apiclient.discovery import build\nfrom httplib2 import Http\nfrom oauth2client.service_account import ServiceAccountCredentials\n\n# TODO: replace this with your partner reseller ID.\nPARTNER_ID = '11036885';\n\n# A single auth scope is used for the zero-touch enrollment customer API.\nSCOPES = ['https://www.googleapis.com/auth/androidworkprovisioning']\nSERVICE_ACCOUNT_KEY_FILE = 'service_account_key.json'\n\ndef get_credential():\n \"\"\"Creates a Credential object with the correct OAuth2 authorization.\n\n Creates a Credential object with the correct OAuth2 authorization\n for the service account that calls the reseller API. The service\n endpoint calls this method when setting up a new service instance.\n\n Returns:\n Credential, the user's credential.\n \"\"\"\n credential = ServiceAccountCredentials.from_json_keyfile_name(\n SERVICE_ACCOUNT_KEY_FILE, scopes=SCOPES)\n return credential\n\n\ndef get_service():\n \"\"\"Creates a service endpoint for the zero-touch enrollment reseller API.\n\n Builds and returns an authorized API client service for v1 of the API. Use\n the service endpoint to call the API methods.\n\n Returns:\n A service Resource object with methods for interacting with the service.\n \"\"\"\n http_auth = get_credential().authorize(Http())\n service = build('androiddeviceprovisioning', 'v1', http=http_auth)\n return service\n\n\ndef main():\n \"\"\"Runs the zero-touch enrollment quickstart app.\n \"\"\"\n # Create a zero-touch enrollment API service endpoint.\n service = get_service()\n\n # Send an API request to list all our customers.\n response = service.partners().customers().list(partnerId=PARTNER_ID).execute()\n\n # Print out the details of each customer.\n if 'customers' in response:\n for customer in response['customers']:\n print 'Name:{0} ID:{1}'.format(\n customer['companyName'], customer['companyId'])\n else:\n print 'No customers found'\n\n\nif __name__ == '__main__':\n main()\n```\n\n### Partner ID\n\nAPI calls typically need your reseller partner ID as an argument. To find your\npartner ID from the zero-touch enrollment portal, follow the steps below:\n\n1. Open the [portal](https://enterprise.google.com/android/zero-touch/resellers). You might need to sign in.\n2. Click settings_ethernet **Service\n accounts**.\n3. Copy your partner ID number from the **Your reseller ID** line.\n\nStep 5: Run the sample\n----------------------\n\nUse your operating system's help to run the script in the file. On UNIX and Mac\ncomputers, run the command below in your terminal: \n\n python quickstart.py\n\n### Printing API responses\n\nTo make it easier to inspect responses when trying out the API, format the JSON\nresponse data. The snippet below shows how you might do this in Python using the\nJSON module: \n\n from json import dumps\n\n # ...\n\n results = provisioning.partners().devices().claimAsync(partnerId=MY_PARTNER_ID,\n body={'claims':new_claims}).execute()\n # Print formatted JSON response\n print dumps(results, indent=4, sort_keys=True)\n\nTroubleshooting\n---------------\n\n\n[Tell us what went wrong]() with the quickstart and we'll work to\nfix it. To learn how zero-touch uses service accounts to authorize API calls, read\n[Authorization](/zero-touch/guides/auth).\n\nLearn more\n----------\n\n- [Google Developers Console help documentation](/console/help/new)\n- [Google APIs Client for Python documentation](/api-client-library/python)\n- [pip User Guide](https://pip.pypa.io/en/stable/user_guide/)"]]
