Cloud Tasks-Clientbibliotheken

Auf dieser Seite werden Sie durch die ersten Schritte mit den Cloud-Clientbibliotheken für die Cloud Tasks API geführt. Weitere Informationen zu den Clientbibliotheken für Cloud APIs finden Sie unter Erläuterung zu Clientbibliotheken.

Clientbibliothek installieren

C#

Weitere Informationen finden Sie unter C#-Entwicklungsumgebung einrichten.

Install-Package Google.Cloud.Tasks.V2 -Version 1.0.0

Go

Weitere Informationen finden Sie unter Entwicklungsumgebung einrichten.

go get cloud.google.com/go/tasks

Java

Weitere Informationen finden Sie unter Java-Entwicklungsumgebung einrichten.

Wenn Sie Maven verwenden, fügen Sie Folgendes in die Datei pom.xml ein:

<dependency>
  <groupId>com.google.cloud</groupId>
  <artifactId>google-cloud-tasks</artifactId>
  <version>1.0.0</version>
</dependency>

Wenn Sie Gradle verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

compile 'com.google.cloud:google-cloud-tasks:1.0.0'

Wenn Sie SBT verwenden, fügen Sie den Abhängigkeiten Folgendes hinzu:

libraryDependencies += "com.google.cloud" % "google-cloud-tasks" % "1.0.0"

Wenn Sie IntelliJ oder Eclipse verwenden, können Sie Ihrem Projekt mithilfe der folgenden IDE-Plug-ins Clientbibliotheken hinzufügen:

Diese Plug-ins bieten zusätzliche Funktionen wie z. B. die Schlüsselverwaltung für Dienstkonten. Einzelheiten finden Sie in der Dokumentation der einzelnen Plug-ins.

Node.js

Weitere Informationen finden Sie unter Node.js-Entwicklungsumgebung einrichten.

npm install --save @google-cloud/tasks

PHP

composer require google/cloud-tasks

Python

Weitere Informationen finden Sie unter Python-Entwicklungsumgebung einrichten.

pip install --upgrade google-cloud-tasks

Ruby

Weitere Informationen finden Sie unter Ruby-Entwicklungsumgebung einrichten.

gem install google-cloud-tasks

Authentifizierung zur Verwendung mit der Clientbibliothek einrichten

Zum Ausführen der Clientbibliothek müssen Sie zuerst die Authentifizierung einrichten. Erstellen Sie ein Dienstkonto mit seinem Schlüssel und legen Sie anschließend eine Umgebungsvariable fest, die auf diesen Schlüssel verweist. Weitere Informationen finden Sie in der Dokumentation zur GCP-Authentifizierung.

GCP CONSOLE

  1. Wechseln Sie in der GCP Console zur Seite Dienstkontoschlüssel erstellen.

    Zur Seite "Dienstkontoschlüssel erstellen"

  2. Wählen Sie aus der Drop-down-Liste Dienstkonto die Option Neues Dienstkonto aus.
  3. Geben Sie im Feld Dienstkontoname einen Namen ein.
  4. Wählen Sie in der Drop-down-Liste Rolle die Option Projekt > Inhaber aus.
  5. Klicken Sie auf Erstellen. Eine JSON-Datei mit Ihrem Schlüssel wird auf Ihren Computer heruntergeladen.

BEFEHLSZEILE

Sie können die folgenden Befehle mithilfe des Cloud SDK auf Ihrem lokalen Computer oder in Cloud Shell ausführen.

  1. Erstellen Sie das Dienstkonto. Geben Sie für [NAME] den Namen des gewünschten Dienstkontos an.

    gcloud iam service-accounts create [NAME]
    
  2. Gewähren Sie Berechtigungen für das Dienstkonto. Ersetzen Sie [PROJECT_ID] durch Ihre Projekt-ID.

    gcloud projects add-iam-policy-binding [PROJECT_ID] --member
    "serviceAccount: [NAME]@[PROJECT_ID].iam.gserviceaccount.com" --role
    "roles/owner"
    
  3. Erstellen Sie die Schlüsseldatei. Geben Sie für [FILE_NAME] einen Namen für die Schlüsseldatei an.

    gcloud iam service-accounts keys create [FILE_NAME].json --iam-account
    [NAME]@[PROJECT_ID].iam.gserviceaccount.com
    

Die Anmeldedaten zur Authentifizierung (den heruntergeladenen Schlüssel) geben Sie durch Festlegung der Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS an. Diese muss auf die Datei verweisen, in der Sie den Schlüssel gespeichert haben. Geben Sie für [PATH] den Dateipfad der JSON-Datei an, die Ihren Dienstkontoschlüssel enthält, und für [FILE_NAME] den Dateinamen. Diese Variable gilt nur für Ihre aktuelle Shellsitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable neu festlegen.

LINUX ODER MACOS

export GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

export GOOGLE_APPLICATION_CREDENTIALS="/home/user/Downloads/[FILE_NAME].json"

WINDOWS

Mit PowerShell:

$env:GOOGLE_APPLICATION_CREDENTIALS="[PATH]"

Beispiel:

$env:GOOGLE_APPLICATION_CREDENTIALS="C:\Users\username\Downloads\[FILE_NAME].json"

Clientbibliothek verwenden

Beispiele zur Verwendung der Clientbibliothek finden Sie unter HTTP-Zielaufgaben erstellen oder unter App Engine-Aufgaben erstellen

Zusätzliche Ressourcen