Einstellungen für die Auslieferung verwalten

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

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

Steuerelemente für die Bereitstellung aufrufen und bearbeiten

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

Steuerelemente für die Bereitstellung in der Console aufrufen und bearbeiten

Der Tab Steuerelemente für die Bereitstellung auf der Seite „Steuerelemente“ enthält alle Steuerelemente für die Bereitstellung und die zugehörigen Bereitstellungskonfigurationen. Klicken Sie auf das Symbol Steuerelement bearbeiten für ein Steuerelement, um die Einstellungen und zugehörigen Bereitstellungskonfigurationen im Bereich Steuerelement bearbeiten zu ändern. Klicken Sie auf das Symbol Steuerelement löschen, um ein Steuerelement zu löschen. Dadurch wird es auch aus allen Bereitstellungskonfigurationen entfernt.

Die Steuerelemente 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 Bereitstellungssteuerelemente für diese Konfiguration aufgeführt sind. Klicken Sie auf das Symbol Steuerelement bearbeiten für ein Steuerelement, um die Einstellungen im Bereich Steuerelement bearbeiten zu ändern. Klicken Sie auf das Symbol Steuerelement entfernen, um die Verknüpfung des Steuerelements mit der Bereitstellungskonfiguration aufzuheben. Das Steuerelement wird dadurch nicht gelöscht.

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

Steuerelemente für die Bereitstellung inline ansehen

Wenn Sie eine einzelne Bereitstellungssteuerung inline sehen möchten, verwenden Sie Control.get.

Weitere Informationen zu dieser Methode findest du 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'

Wenn du mehrere Bereitstellungssteuerungen inline auflisten möchtest, verwende Controls.list.

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.

Wenn Sie nur die Steuerelemente auflisten möchten, die mit einer bestimmten Bereitstellungskonfiguration verknüpft sind, verwenden Sie den Abfrageparameter filter, um die ID der Bereitstellungskonfiguration anzugeben.

Weitere Informationen zu dieser Methode findest du 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 für Patches inline

Wenn Sie Felder in einem Auslieferungskontrollelement aktualisieren möchten, verwenden Sie Controls.patch und fügen Sie dem Anfragetext eine Instanz von Control hinzu. Geben Sie die zu aktualisierenden Felder mit dem Parameter updateMask an oder lassen Sie ihn deaktiviert, um alle unterstützten Felder zu aktualisieren.

Weitere Informationen zu dieser Methode findest du 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'

Steuerelemente Inline zu Bereitstellungskonfigurationen hinzufügen

Verwenden Sie ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement hinzuzufügen.

Weitere Informationen zu dieser Methode findest du in der ServingConfig.addControl API-Referenz.

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

Steuerelemente inline aus Bereitstellungskonfigurationen entfernen

Verwenden Sie ServingConfig.removeControl, um ein Steuerelement aus einer Bereitstellungskonfiguration zu entfernen.

Weitere Informationen zu dieser Methode findest du in der ServingConfig.addControl API-Referenz.

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

Steuerelement für die Bereitstellung löschen

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

Steuerelement für die Bereitstellung in der Console löschen

Sie können ein Steuerelement für die Bereitstellung löschen, um dieses Steuerelement aus allen Bereitstellungskonfigurationen zu entfernen, die es verwenden.

1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen 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.

Steuerelement für die Bereitstellung inline löschen

Verwenden Sie Controls.delete, um Steuerelemente für die Bereitstellung inline zu löschen.

Weitere Informationen zu dieser Methode findest du 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 „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in 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 sollten:

• Sie können Bereitstellungssteuerungen von einem Projekt in ein anderes verschieben.

• So führen Sie eine Bulk-Änderung an allen oder einigen Steuerelementen für die Bereitstellung durch: Exportieren Sie die Bereitstellungseinstellungen, bearbeiten Sie die exportierte Datei und importieren Sie sie dann, um Bereitstellungseinstellungen zu ändern oder hinzuzufügen.

Sie können über die Search for Retail-Konsole exportieren und importieren. Wenn Sie Bereitstellungseinstellungen exportieren, werden alle Bereitstellungseinstellungen im Projekt exportiert.

So exportieren Sie Bereitstellungseinstellungen:

1. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.
   
   Zur Seite „Steuerelemente“

2. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerelemente exportieren.

3. Wählen Sie im Fenster Export Serving Controls (Auslieferungssteuerungen exportieren) den Cloud Storage-Bucket aus, in den Sie die Steuerungsdatei exportieren möchten.

4. Klicken Sie auf Exportieren.

   Die exportierten Steuerelemente werden im ausgewählten Bucket in einer NDJSON-Datei mit dem folgenden Namen gespeichert:

   projects_PROJECT_ID_TIMESTAMP_exported_controls.ndjson

5. Nach Abschluss des Exportvorgangs sehen Sie den Vorgangsstatus in der Liste Aktivitäten für Bulk-Import, -Export und -Löschen im Fenster Aktivitäten exportieren. Öffnen Sie das Fenster Exportaktivität, indem Sie im Nachrichtenfenster auf Anzeigen klicken oder der Anleitung unter Status eines bestimmten Integrationsvorgangs ansehen folgen.

Bereitstellungseinstellungen importieren

Vorschau

Diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Funktionen sind „wie besehen“ verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in den Beschreibungen der Startphase.

Wenn Sie Steuerelemente für die Bereitstellung hinzufügen oder vorhandene in Bulk ändern möchten, können Sie die Änderungen in einer exportierten Steuerelementdatei vornehmen. Sie können sie dann in das ursprüngliche Projekt oder in ein anderes Projekt importieren.

Wissenswertes zum Importieren von Bereitstellungseinstellungen:

• Sie können eine Datei mit Bereitstellungseinstellungen nicht importieren, wenn sie sowohl Bereitstellungseinstellungen für Suchergebnisse 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, wird diese Verknüpfung ebenfalls beibehalten.

So importierst du Einstellungen für die Auslieferung:

1. Bearbeiten und prüfen Sie eine exportierte Bereitstellungskontrolldatei und legen Sie sie in einem Cloud Storage-Bucket ab. Informationen zum Exportieren von Bereitstellungseinstellungen finden Sie in der vorherigen Aufgabe Bereitstellungseinstellungen exportieren.

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

2. Rufen Sie in der Console „Suchen für Einzelhandel“ die Seite Einstellungen auf.
   
   Zur Seite „Steuerelemente“

3. Klicken Sie auf dem Tab Steuerelemente für die Bereitstellung auf Steuerelemente importieren.

4. Gehen Sie im Fenster Bereitstellungseinstellungen importieren so vor:

   1. Wählen Sie den Cloud Storage-Bucket und die NDJSON-Datei mit den Steuerelementen aus, die Sie importieren möchten.

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

   3. Sehen Sie sich den Importvorschauplan an. Die Steuerelemente, die erstellt werden, werden auf dem Tab Neu angezeigt. Die Steuerelemente, die geändert werden, werden auf dem Tab Geändert angezeigt.

5. Klicken Sie auf Importieren.

   Es wird ein Vorgang mit langer Ausführungszeit gestartet, um die neuen und geänderten Steuerelemente zu importieren.

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