Bereitstellungseinstellungen verwalten

Auf dieser Seite wird beschrieben, wie Sie Bereitstellungseinstellungen aufrufen, bearbeiten, löschen, exportieren und importieren.

Allgemeine Informationen zu Bereitstellungseinstellungen und eine Anleitung zum Erstellen von Bereitstellungseinstellungen finden Sie unter Bereitstellungseinstellungen und Bereitstellungseinstellungen erstellen.

Bereitstellungseinstellungen aufrufen und bearbeiten

Sie können Bereitstellungseinstellungen für Vertex AI Search for Commerce über die Console und die API aufrufen.

Bereitstellungseinstellungen in der Console aufrufen und bearbeiten

Der Tab Bereitstellungseinstellungen auf der Seite „Steuerelemente“ enthält alle Bereitstellungseinstellungen und die zugehörigen Bereitstellungskonfigurationen. Klicken Sie bei einer Einstellung auf das Symbol Einstellung bearbeiten, um die Einstellungen und die zugehörigen Bereitstellungskonfigurationen im Bereich Einstellung bearbeiten zu ändern. Klicken Sie bei einer Einstellung auf das Symbol Einstellung löschen, um sie zu löschen. Dadurch wird sie auch aus allen Bereitstellungskonfigurationen entfernt.

Die Einstellungen für eine bestimmte Bereitstellungskonfiguration können Sie auch auf der Seite **Bereitstellungskonfigurationen** aufrufen und bearbeiten. Klicken Sie auf eine Bereitstellungskonfiguration, um die Seite Details aufzurufen, auf der alle Bereitstellungseinstellungen für diese Konfiguration aufgeführt sind. Klicken Sie bei einer Einstellung auf das Symbol Einstellung bearbeiten, um die Einstellungen im Bereich Einstellung bearbeiten zu ändern. Klicken Sie auf das Symbol Einstellung entfernen, um die Einstellung von der Bereitstellungskonfiguration zu trennen. Dadurch wird die Einstellung nicht gelöscht.

Es dauert einige Minuten, bis neu erstellte oder aktualisierte Steuerelemente für die Bereitstellung von Live-Traffic verfügbar sind. Auf der Seite Bewerten in der Console können Sie testen, ob Ihre Änderungen auf angewendet wurden.

Bereitstellungseinstellungen inline aufrufen

Verwenden Sie Control.get, um eine einzelne Bereitstellungseinstellung inline aufzurufen.

Weitere Informationen zu dieser Methode finden Sie in der Control.get API-Referenz.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID'

Verwenden Sie Controls.list, um mehrere Bereitstellungseinstellungen inline aufzulisten.

Optional können Sie mit dem Parameter pageSize eine maximale Anzahl von Ergebnissen festlegen, die zurückgegeben werden sollen. Wenn weitere Ergebnisse verfügbar sind, enthält die list-Antwort ein Seitentoken. Sie können ein Seitentoken im Parameter pageToken einer list-Anfrage übergeben, um die nächste Ergebnisseite abzurufen.

Verwenden Sie den Abfrageparameter filter, um nur die Einstellungen aufzulisten, die mit einer bestimmten Bereitstellungskonfiguration verknüpft sind. Geben Sie dazu die ID der Bereitstellungskonfiguration an.

Weitere Informationen zu dieser Methode finden Sie in der Control.list API-Referenz.

curl -X GET \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls?pageSize=PAGE_SIZE&pageToken=PAGE_TOKEN&filter=servingConfig=SERVING_CONFIG_ID

Bereitstellungseinstellungen inline patchen

Verwenden Sie Controls.patch um Felder in einer Bereitstellungseinstellung zu aktualisieren, und fügen Sie eine Instanz von Control in den Anfragetext ein. Geben Sie die zu aktualisierenden Felder mit dem Parameter updateMask an oder lassen Sie ihn nicht festgelegt, um alle unterstützten Felder zu aktualisieren.

Weitere Informationen zu dieser Methode finden Sie in der Controls.patch API-Referenz.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d '{
      "name": "projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID",
      "FIELD_NAME_1": "NEW_FIELD_VALUE_1"
      "FIELD_NAME_2": "NEW_FIELD_VALUE_2"
    }' \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/CONTROL_ID?updateMask=FIELD_NAME_1,FIELD_NAME_2'

Bereitstellungskonfigurationen inline Einstellungen hinzufügen

Verwenden Sie ServingConfig.addControl, um einer Bereitstellungskonfiguration eine Einstellung hinzuzufügen.

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.

Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Bereitstellungskonfigurationen inline Einstellungen entfernen

Verwenden Sie ServingConfig.removeControl, um eine Einstellung aus einer Bereitstellungskonfiguration zu entfernen.

Weitere Informationen zu dieser Methode finden Sie in der ServingConfig.addControl API-Referenz.

Ein Beispiel für diese Methode finden Sie unter Bereitstellungskonfigurationen verwalten.

Bereitstellungseinstellung löschen

Sie können eine Bereitstellungseinstellung über die Console oder inline mit der Methode Controls.delete löschen.

Bereitstellungseinstellung in der Console löschen

Sie können eine Bereitstellungseinstellung löschen, um diese Einstellung aus allen Bereitstellungskonfigurationen zu entfernen, die sie verwenden.

1. Rufen Sie in der Search for Commerce Console die Seite Steuerelemente auf.
   
   Zur Seite "Steuerelemente"

2. Klicken Sie in der Tabellenzeile des Steuerelements, das Sie entfernen möchten, auf Löschen.

3. Klicken Sie im Bestätigungsfenster auf Löschen, um den Löschvorgang abzuschließen.

Bereitstellungseinstellung inline löschen

Verwenden Sie Controls.delete, um Bereitstellungseinstellungen inline zu löschen.

Weitere Informationen zu dieser Methode finden Sie in der Controls.delete API-Referenz.

curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
'https://retail.googleapis.com/v2beta/projects/PROJECT_NUMBER/locations/global/catalogs/default_catalog/controls/SERVING_CONTROL_ID'

Bereitstellungseinstellungen exportieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Sie können Ihre Bereitstellungseinstellungen in eine Datei in einem Cloud Storage-Bucket exportieren.

Es gibt zwei Gründe, warum Sie Bereitstellungseinstellungen exportieren und importieren möchten:

• Um Bereitstellungseinstellungen von einem Projekt in ein anderes zu verschieben.

• Um eine Massenbearbeitung für alle oder einige Bereitstellungseinstellungen durchzuführen. Exportieren Sie die Bereitstellungseinstellungen, bearbeiten Sie die exportierte Datei und importieren Sie die Datei dann, um Bereitstellungseinstellungen zu ändern oder hinzuzufügen.

Sie können über die Search for Commerce Console exportieren und importieren. Wenn Sie Bereitstellungseinstellungen exportieren, exportieren Sie alle Bereitstellungseinstellungen im Projekt.

So exportieren Sie Bereitstellungseinstellungen:

1. Rufen Sie in der Search for Commerce Console die Seite Steuerelemente auf.
   
   Zur Seite "Steuerelemente"

2. Klicken Sie auf dem Tab Bereitstellungseinstellungen auf Einstellungen exportieren.

3. Wählen Sie im Fenster Bereitstellungseinstellungen exportieren den Cloud Storage-Bucket aus, in den Sie die Einstellungsdatei exportieren möchten.

4. Klicken Sie auf Exportieren.

   Die exportierten Einstellungen werden in einer NDJSON-Datei im ausgewählten Bucket mit einem Namen im folgenden Format gespeichert:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Nach Abschluss des Exportvorgangs können Sie den Vorgangsstatus im Fenster Exportaktivität in der Liste Massenimport-, ‑export- und ‑löschaktivitäten sehen. Öffnen Sie das Fenster Exportaktivität , indem Sie im Meldungsfenster auf Anzeigen klicken oder der Anleitung unter Status eines bestimmten Integrationsvorgangs ansehen folgen.

Bereitstellungseinstellungen importieren

Vorschau

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie Bereitstellungseinstellungen im Bulk hinzufügen oder vorhandene Einstellungen ändern möchten, können Sie die Änderungen in einer exportierten Einstellungsdatei vornehmen. Anschließend können Sie sie in das ursprüngliche Projekt oder in ein anderes Projekt importieren.

Wichtige Informationen zum Importieren von Bereitstellungseinstellungen:

• Sie können keine Datei mit Bereitstellungseinstellungen importieren, wenn sie sowohl Bereitstellungseinstellungen für die Suche als auch für Empfehlungen enthält.

• Wenn Sie Bereitstellungseinstellungen importieren, werden alle Bereitstellungseinstellungen in der Datei mit der Bereitstellungskonfiguration verknüpft, die Sie beim Import angeben. Wenn eine Bereitstellungseinstellung bereits mit einer anderen Bereitstellungskonfiguration im Projekt verknüpft ist, bleibt diese Verknüpfung ebenfalls erhalten.

So importieren Sie Bereitstellungseinstellungen:

1. Bearbeiten und überprüfen Sie eine exportierte Datei mit Bereitstellungseinstellungen und platzieren Sie die Datei in einem Cloud Storage-Bucket. Informationen zum Exportieren von Bereitstellungseinstellungen finden Sie im vorherigen Abschnitt Bereitstellungseinstellungen exportieren.

   Die Datei darf nur Bereitstellungseinstellungen für die Suche oder nur Bereitstellungseinstellungen für Empfehlungen enthalten. Sie können keine Datei importieren, die beide Typen enthält.

2. Rufen Sie in der Search for Commerce Console die Seite Steuerelemente auf.
   
   Zur Seite "Steuerelemente"

3. Klicken Sie auf dem Tab Bereitstellungseinstellungen auf Einstellungen importieren.

4. Gehen Sie im Fenster Bereitstellungseinstellungen importieren so vor:

   1. Suchen und wählen Sie den Cloud Storage-Bucket und die NDJSON-Datei aus, die die Einstellungen enthält, die Sie importieren möchten.

   2. Wählen Sie die Bereitstellungskonfiguration aus, mit der Sie die importierten Bereitstellungseinstellungen verknüpfen möchten.

   3. Überprüfen Sie den Importplan in der Vorschau. Die Einstellungen, die erstellt werden, werden auf dem Tab Neu angezeigt. Die Einstellungen, die geändert werden, werden auf dem Tab Geändert angezeigt.

5. Klicken Sie auf Importieren.

   Ein Vorgang mit langer Ausführungszeit wird gestartet, um die neuen und geänderten Einstellungen zu importieren.

6. Nach Abschluss des Importvorgangs können Sie den Vorgangsstatus im Fenster Aktivitätsstatus auf dem Tab Steuerelemente sehen. Öffnen Sie das Fenster Aktivitäts status , indem Sie im Meldungsfenster auf Anzeigen klicken oder der Anleitung unter Status eines bestimmten Integrationsvorgangs ansehen folgen.