Erste Schritte mit der Service Management API

Auf dieser Seite wird beschrieben, wie Sie Ihre Entwicklungsumgebung für die Arbeit mit der Service Management API einrichten. Unsere Empfehlung für die meisten Anwendungsfälle im Produktivbetrieb – und die einfachste Art, mit Service Management API zu arbeiten – ist der Zugriff über die gcloud Befehlszeile (statt über die webbasierte Benutzeroberfläche der Google Cloud Console). Für eine Programmierung unter Einbindung der Service Management API empfehlen wir eine unserer verfügbaren Clientbibliotheken. Sie können die unten stehende alternative Anleitung sowie den Befehl curl verwenden, um die API zu testen, ohne eine komplette Anwendungsentwicklungsumgebung einzurichten.

Mit gcloud einrichten

  1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

  2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  3. Enable the Service Management API.

    Enable the API

  4. Install the Google Cloud CLI.

  5. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  6. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  7. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Go to project selector

  8. Enable the Service Management API.

    Enable the API

  9. Install the Google Cloud CLI.

  10. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  11. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

    12. Direkten API-Aufruf einrichten

    In diesem Abschnitt werden die grundlegenden Schritte zum Einrichten Ihrer lokalen Umgebung und zum Testen der Service Management API mit dem curl-Befehl beschrieben. Diese Schritte richten sich an Entwickler, die unter Einbindung der Service Management API programmieren.

    Ersteinrichtung

    1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

    2. Install the Google Cloud CLI.

    3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    4. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

      gcloud init

    5. Create or select a Google Cloud project.

      • Create a Google Cloud project:

        gcloud projects create PROJECT_ID

        Replace PROJECT_ID with a name for the Google Cloud project you are creating.

      • Select the Google Cloud project that you created:

        gcloud config set project PROJECT_ID

        Replace PROJECT_ID with your Google Cloud project name.

    6. Enable the Service Management API: 

      gcloud services enable servicemanagement.googleapis.com

    7. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

      Replace the following:

      • PROJECT_ID: your project ID.
      • USER_IDENTIFIER: the identifier for your user account—for example, myemail@example.com.
      • ROLE: the IAM role that you grant to your user account.

    8. Install the Google Cloud CLI.

    9. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

    10. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

      gcloud init

    11. Create or select a Google Cloud project.

      • Create a Google Cloud project:

        gcloud projects create PROJECT_ID

        Replace PROJECT_ID with a name for the Google Cloud project you are creating.

      • Select the Google Cloud project that you created:

        gcloud config set project PROJECT_ID

        Replace PROJECT_ID with your Google Cloud project name.

    12. Enable the Service Management API: 

      gcloud services enable servicemanagement.googleapis.com

    13. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/servicemanagement.admin 

      gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE

      Replace the following:

      • PROJECT_ID: your project ID.
      • USER_IDENTIFIER: the identifier for your user account—for example, myemail@example.com.
      • ROLE: the IAM role that you grant to your user account.
      14.

      Mit curl testen

      1. Definieren Sie ein geeignetes Shell-Alias zum Aufrufen der Google REST APIs:

        $ alias gcurl='curl -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"'

      2. Versuchen Sie, öffentlich zugängliche Dienste aufzulisten:

        $ gcurl https://servicemanagement.googleapis.com/v1/services

        Wenn eine Liste der Dienste angezeigt wird, war die Einrichtung erfolgreich.

      Weitere Informationen

      Wenn Sie Cloud Endpoints nicht zum Erstellen eines verwalteten Dienstes verwenden, gehen Sie so vor:

      1. Folgen Sie den Schritten in Dienste erstellen und löschen, um eine Ressource für verwaltete Dienste auf oberster Ebene zu erstellen.

      2. Folgen Sie den Schritten unter Dienstkonfigurationen verwalten, um Dienstkonfigurationen zu senden, die vom Dienst verwendete Funktionen beschreiben.

      3. Informationen zum Bereitstellen Ihrer Dienstkonfigurationen finden Sie unter Dienstkonfigurationen bereitstellen.