Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Folgen Sie dieser Anleitung, um das SDK und den Beispielcode in Ihrem Projekt zu installieren.
Führen Sie alle Befehle auf dieser Seite in einem Terminal auf dem Gerät aus (entweder
direkt oder über eine SSH-Verbindung).
Umgebung konfigurieren
Eine virtuelle Python-Umgebung verwenden
um das SDK und seine Abhängigkeiten von den Python-Systempaketen zu isolieren.
(Empfohlen) Für Python 3:
sudo apt-get updatesudo apt-get install python3-dev python3-venv # Use python3.4-venv if the package cannot be found.python3 -m venv envenv/bin/python -m pip install --upgrade pip setuptools wheelsource env/bin/activate
Das Google Assistant SDK-Paket enthält den gesamten Code, der zum Abrufen der
Google Assistant, der auf dem Gerät ausgeführt wird, einschließlich des Beispielcodes.
Installieren Sie die Systemabhängigkeiten des Pakets:
Anmeldedaten generieren, um den Beispielcode und die Tools ausführen zu können Nachschlagewerke
die JSON-Datei, die Sie in einem vorherigen
Schritt:
müssen Sie sie möglicherweise auf das Gerät kopieren. Benennen Sie diese Datei nicht um.
Please visit this URL to authorize this application: https://...
Kopieren Sie die URL und fügen Sie sie in einen Browser ein. Dies ist auf jedem System möglich.
Auf dieser Seite werden Sie aufgefordert, sich in Ihrem Google-Konto anzumelden. Melden Sie sich im
Google-Konto, mit dem das Entwicklerprojekt im vorherigen Schritt erstellt wurde
Schritt:
Nachdem Sie die Berechtigungsanfrage von der API genehmigt haben, wird ein Code angezeigt.
in Ihrem Browser angezeigt, z. B. „4/XXXX“. Kopieren Sie diesen Code und fügen Sie ihn
Terminal:
Enter the authorization code:
Wenn die Autorisierung erfolgreich war, sehen Sie eine Antwort ähnlich der folgenden:
Folgendes:
Wird stattdessen InvalidGrantError angezeigt, wurde ein ungültiger Code eingegeben.
Versuchen Sie es noch einmal. Achten Sie dabei darauf, den gesamten Code zu kopieren und einzufügen.
[null,null,["Zuletzt aktualisiert: 2025-07-26 (UTC)."],[[["\u003cp\u003eThese instructions guide you through installing the Google Assistant SDK and sample code on a Linux device, primarily focusing on Python environments.\u003c/p\u003e\n"],["\u003cp\u003eYou'll set up a Python virtual environment, install necessary dependencies, and obtain the Google Assistant SDK package using pip.\u003c/p\u003e\n"],["\u003cp\u003eGenerating credentials involves authorizing your Google account to access the Assistant SDK and saving the credentials for API calls.\u003c/p\u003e\n"],["\u003cp\u003eAfter successful installation and credential generation, you can proceed to run the provided sample code.\u003c/p\u003e\n"]]],[],null,["# Install the SDK and Sample Code\n\nFollow these instructions to install the SDK and sample code in your project.\nRun all of the commands on this page in a terminal on the device (either\ndirectly or via an SSH connection).\n| **Note:** These instructions assume a Python environment running on a Linux platform. The SDK and sample code are currently only available in Python, but the Google Service API is available in many [other languages and platforms](/assistant/sdk/guides/service/integrate#other-languages).\n\nConfigure the environment\n-------------------------\n\nUse a [Python virtual environment](https://docs.python.org/3/library/venv.html)\nto isolate the SDK and its dependencies from the system Python packages.\n| **Note:** For the Raspberry Pi, run the following commands from the `/home/pi` directory.\n\n(Recommended) For Python 3: \n\n sudo apt-get update\n sudo apt-get install python3-dev python3-venv # Use python3.4-venv if the package cannot be found.\n python3 -m venv env\n env/bin/python -m pip install --upgrade pip setuptools wheel\n source env/bin/activate\n\nFor Python 2.7: \n\n sudo apt-get update\n sudo apt-get install python-dev python-virtualenv\n virtualenv env --no-site-packages\n env/bin/python -m pip install --upgrade pip setuptools wheel\n source env/bin/activate\n\nGet the package\n---------------\n\nThe Google Assistant SDK package contains all the code required to get the\nGoogle Assistant running on the device, including the sample code.\n\nInstall the package's system dependencies: \n\n```\nsudo apt-get install portaudio19-dev libffi-dev libssl-dev\n```\n\n\u003cbr /\u003e\n\nUse `pip` to install the latest version of the [Python package](https://pypi.python.org/pypi/google-assistant-library)\nin the virtual environment: \n\n```\npython -m pip install --upgrade google-assistant-sdk[samples]\n```\n\n\u003cbr /\u003e\n\nGenerate credentials\n--------------------\n\n1. Install or update the authorization tool:\n\n ```\n python -m pip install --upgrade google-auth-oauthlib[tool]\n ```\n\n \u003cbr /\u003e\n\n2. Generate credentials to be able to run the sample code and tools. Reference\n the JSON file you downloaded in a previous\n\n [step](/assistant/sdk/guides/service/python/embed/register-device#download-credentials);\n\n you may need to copy it the device. Do not rename this file.\n\n ```\n google-oauthlib-tool --scope https://www.googleapis.com/auth/assistant-sdk-prototype \\\n --save --headless --client-secrets /path/to/client_secret_client-id.json\n ```\n\n You should see a URL displayed in the terminal: \n\n ```\n Please visit this URL to authorize this application: https://...\n ```\n\n \u003cbr /\u003e\n\n3. Copy the URL and paste it into a browser (this can be done on any system).\n The page will ask you to sign in to your Google account. Sign into the\n Google account that created the developer project in the previous\n\n [step](/assistant/sdk/guides/service/python/embed/config-dev-project-and-account#config-dev-project).\n\n | **Note:** To use other accounts, first [add those accounts](https://cloud.google.com/iam/docs/granting-changing-revoking-access) to your Actions Console project as Owners.\n4. After you approve the permission request from the API, a code will appear\n in your browser, such as \"4/XXXX\". Copy and paste this code into the\n terminal:\n\n ```\n Enter the authorization code:\n ```\n\n If authorization was successful, you will see a response similar to\n the following: \n\n ```\n credentials saved: /path/to/.config/google-oauthlib-tool/credentials.json\n ```\n\n If instead you see `InvalidGrantError`, then an invalid code was entered.\n Try again, taking care to copy and paste the entire code.\n | **Note:** The authorization tool creates a new `credentials.json` file in a hidden `.config` directory on the device. This file contains an access token that is used to call the Google Assistant API.\n\nNext step\n---------\n\n[Run the Sample Code](/assistant/sdk/guides/service/python/embed/run-sample)"]]
