Diese Seite wurde von der Cloud Translation API übersetzt.
Switch to English

Schnellstart

Die Cloud Inference API ermöglicht eine problemlose Integration der Google-Suche und Analysetechnologien für Zeitachsendaten in Anwendungen. Mit der Cloud Inference API haben Sie folgende Möglichkeiten:

  • Zeitreihen-Datasets verarbeiten:
    • JSON in abfrageeffiziente interne Formate aufnehmen
    • Bereits übermittelte Datensätze aus dem System entfernen
    • Aktive Datasets im System auflisten, die von Ihrem Projekt gesendet wurden
  • Inferenzabfragen über geladene Datasets ausführen:
    • Wie korrelieren die Werte verschiedener Typen? Zum Beispiel: Welche Labels korrelieren in einem Dataset mit gekennzeichneten Nachrichtenartikeln mit Artikeln über Urlaub?
    • Wie variiert die Häufigkeit der Ereignisse im Laufe der Zeit? Beispiel: An welchen Tagen gibt es ungewöhnlich viele ähnliche Ereignisse zu bestimmten Themen?
    • Wie hoch ist die Hintergrundwahrscheinlichkeit für ein Ereignis im System? Zum Beispiel: Wie oft erscheinen Bilder von verschiedenen Sportarten in den Artikeln?

Weitere Informationen finden Sie unter Was ist die Cloud Inference API?.

Hinweis

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
  2. Wählen Sie in der Google Cloud Console auf der Seite der Projektauswahl ein Google Cloud-Projekt aus oder erstellen Sie eines.

    Zur Projektauswahl

  3. Die Abrechnung für das Cloud-Projekt muss aktiviert sein. So prüfen Sie, ob die Abrechnung für Ihr Projekt aktiviert ist.

  4. Aktivieren Sie die Cloud Inference API.

    Aktivieren Sie die API

  5. Erstellen Sie ein Dienstkonto:

    1. Wechseln Sie in der Cloud Console zur Seite Dienstkonto erstellen.

      Zur Seite „Dienstkonto erstellen“
    2. Wählen Sie ein Projekt aus.
    3. Geben Sie im Feld Dienstkontoname einen Namen ein. In der Cloud Console wird das Feld Dienstkonto-ID anhand dieses Namens ausgefüllt.

      Geben Sie im Feld Dienstkontobeschreibung eine Beschreibung ein. Beispiel: Service account for quickstart.

    4. Klicken Sie auf Erstellen.
    5. Klicken Sie auf das Feld Rolle auswählen.

      Klicken Sie unter Schnellzugriff auf Einfach und dann auf Inhaber.

    6. Klicken Sie auf Weiter.
    7. Klicken Sie auf Fertig, um das Erstellen des Dienstkontos abzuschließen.

      Schließen Sie das Browserfenster nicht. Sie verwenden es in der nächsten Aufgabe.

  6. Dienstkontoschlüssel erstellen

    1. Klicken Sie in der Cloud Console auf die E-Mail-Adresse des von Ihnen erstellten Dienstkontos.
    2. Klicken Sie auf Schlüssel.
    3. Klicken Sie auf Schlüssel hinzufügen und dann auf Neuen Schlüssel erstellen.
    4. Klicken Sie auf Erstellen. Daraufhin wird eine JSON-Schlüsseldatei auf Ihren Computer heruntergeladen.
    5. Klicken Sie auf Schließen.
  7. Legen Sie für die Umgebungsvariable GOOGLE_APPLICATION_CREDENTIALS den Pfad der JSON-Datei fest, die Ihren Dienstkontoschlüssel enthält. Diese Variable gilt nur für Ihre aktuelle Shellsitzung. Wenn Sie eine neue Sitzung öffnen, müssen Sie die Variable noch einmal festlegen.

  8. Installieren und initialisieren Sie das Cloud SDK.

Dataset hochladen

Sie erstellen ein Cloud Inference API-Dataset mithilfe der createdataset-REST-Methode.

  1. Erstellen Sie eine JSON-Anfragedatei mit dem folgenden Text und speichern Sie diese als Nur-Text-Datei create-gdelt-dataset.json:

    {
      "name":"gdelt_2018_04_data",
      "data_names": [
        "PageURL",
        "PageDomain",
        "PageCountry",
        "PageLanguage",
        "PageTextTheme",
        "PageTextGeo",
        "ImageURL",
        "ImagePopularityRawScore",
        "ImagePopularity",
        "ImageSafeSearch",
        "ImageLabel",
        "ImageWebEntity",
        "ImageWebEntityBestGuessLabel",
        "ImageGeoLandmark",
        "ImageFaceToneHas"
      ],
      "data_sources": [
        { "uri":"gs://inference-gdelt-demo/inference-gdelt-demo.201804.json" },
      ]
    }
    

    Dieses JSON-Snippet zeigt an, dass wir ein Dataset erstellen möchten, das aus GDELT-annotierten Nachrichtenartikeln besteht, für die wir Cloud Inference API-Abfragen ausführen möchten. die zur Verfügung gestellt werden.) Das Dataset ist öffentlich zugänglich, deshalb sind keine Anmeldedaten nötig, um darauf zuzugreifen. Sie brauchen allerdings Anmeldedaten, um die API zu verwenden.

  2. Überprüfen Sie, ob Sie über ein Autorisierungstoken verfügen:

    gcloud auth application-default print-access-token
      
  3. Verwenden Sie curl, um eine createdataset-Anfrage zu senden. Dabei übergeben Sie das Zugriffstoken und den Dateinamen der in Schritt 1 eingerichteten JSON-Anfrage:

    curl -s -H "Content-Type: application/json" \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      https://infer.googleapis.com/v1/projects/PROJECT_NUMBER/datasets \
      -d @create-gdelt-dataset.json
      

    Beachten Sie, dass Sie bei Übergabe eines Dateinamens an curl die Option -d (für "Daten") verwenden und vor den Dateinamen ein @-Zeichen setzen müssen. Diese Datei sollte sich in dem Verzeichnis befinden, in dem Sie den Befehl curl ausführen.

    Die Antwort sieht ungefähr so aus:

    {
      "name": "gdelt_2018_04_data",
      "state": "STATE_PENDING"
    }
    

Status der hochgeladenen Datasets abrufen

Sie können den Status für alle Datasets, die Sie zur Verarbeitung an die Cloud Inference API gesendet haben, von Ihrem Clientprojekt mit der REST-Methode ListDataSets abrufen.

  1. Besorgen Sie sich ein Zugriffstoken, wie es beim Erstellen von Datasets im vorherigen Schritt gemacht wurde.

  2. Verwenden Sie curl, um eine listdatasets-Anfrage zu senden und das Zugriffstoken zu übergeben:

    curl -s -H "Content-Type: application/json" \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      https://infer.googleapis.com/v1/projects/PROJECT_NUMBER/datasets
      

Geladenes Dataset abfragen

  1. Erstellen Sie eine JSON-Anfragedatei mit dem folgenden Text und speichern Sie diese als Nur-Text-Datei query-gdelt-dataset.json:

    {
      "name": "gdelt_2018_04_data",
      "queries": [{
        "query": {
          "type": "TYPE_TERM",
          "term": {
          "name": "ImageWebEntity",
          "value": "Vacation"
          }
        },
        "distribution_configs": {
          "bgprob_exp": 0.7,
          "data_name": "ImageLabel",
          "max_result_entries": 5,
        }
      }]
    }

    Dieses JSON-Snippet gibt an, dass das Dataset 'gdelt_2018_04_data', das wir zuvor an die Cloud Inference API gesendet haben, mit einer createdataset-Anfrage abgefragt werden soll, die als in STATE_LOADED gemeldet gemeldet wurde. Die Abfrage selbst zeigt an, dass ImageLabels aus allen Artikeln zusammengefasst werden sollen, die "Vacation" als Entität enthalten. Dazu sollen die Top 5 der am besten bewerteten Labels ausgegeben werden.

  2. Besorgen Sie sich ein Zugriffstoken, wie es beim Erstellen von Datasets im vorherigen Schritt gemacht wurde.

  3. Verwenden Sie curl, um eine query-Anfrage zu senden. Dabei übergeben Sie das Zugriffstoken und den Dateinamen der in Schritt 1 eingerichteten JSON-Anfrage:

    curl -s -H "Content-Type: application/json" \
      -H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
      https://infer.googleapis.com/v1/projects/PROJECT_NUMBER/datasets/gdelt_2018_04_data:query \
      -d @query-gdelt-dataset.json
      

    Beachten Sie, dass Sie bei Übergabe eines Dateinamens an curl die Option -d (für "Daten") verwenden und vor den Dateinamen ein @-Zeichen setzen müssen. Diese Datei sollte sich in dem Verzeichnis befinden, in dem Sie den Befehl curl ausführen.

    Die Antwort sieht ungefähr so aus:

    {
      "results": [
        {
          "distributions": [
            {
              "dataName": "ImageLabel",
              "matchedGroupCount": "39124",
              "totalGroupCount": "7616785",
              "entries": [
                {
                  "value": "ImageLabel=vacation",
                  "score": 31.515648,
                  "matchedGroupCount": "37806",
                  "totalGroupCount": "52331"
                },
                {
                  "value": "ImageLabel=beach",
                  "score": 15.222198,
                  "matchedGroupCount": "6825",
                  "totalGroupCount": "12527"
                },
                {
                  "value": "ImageLabel=summer",
                  "score": 13.984301,
                  "matchedGroupCount": "6704",
                  "totalGroupCount": "13780"
                },
                {
                  "value": "ImageLabel=travel",
                  "score": 13.344194,
                  "matchedGroupCount": "6837",
                  "totalGroupCount": "15158"
                },
                {
                  "value": "ImageLabel=sun_tanning",
                  "score": 12.208676,
                  "matchedGroupCount": "2048",
                  "totalGroupCount": "2999"
                }
              ]
            }
          ]
        }
      ]
    }
      

    Die zurückgegebene Antwort ist eine Verteilung von ImageLabel-Ereignissen, ausgedrückt durch Korrelation mit ImageWebEntity=Vacation. Die gut bewerteten Ereignisse zeigen eine positive Korrelation mit Artikeln zum Thema Urlaub.