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 Steuerelementen für die Bereitstellung finden Sie unter Bereitstellungseinstellungen und Bereitstellungseinstellungen erstellen.

Bereitstellungseinstellungen ansehen und bearbeiten

Sie können die Bereitstellungseinstellungen für Vertex AI Search für den Einzelhandel mithilfe der Console und der API ansehen.

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

Auf der Seite „Steuerelemente“ werden auf dem Tab Auslieferungssteuerung alle Bereitstellungseinstellungen und die zugehörigen Bereitstellungskonfigurationen aufgelistet. Wenn Sie die Einstellungen eines Steuerelements und die zugehörigen Bereitstellungskonfigurationen im Bereich Steuerelement bearbeiten ändern möchten, klicken Sie auf das Symbol Steuerelement bearbeiten. Wenn Sie ein Steuerelement löschen möchten, klicken Sie auf das Symbol Steuerelement löschen. Dadurch wird es auch aus allen Bereitstellungskonfigurationen entfernt.

Sie können die Steuerelemente für eine bestimmte Bereitstellungskonfiguration auch auf der Seite Bereitstellungskonfigurationen ansehen und bearbeiten. Klicken Sie auf eine Bereitstellungskonfiguration, um die zugehörige Seite Details aufzurufen, auf der alle Bereitstellungseinstellungen für diese Konfiguration aufgeführt sind. Wenn Sie die Einstellungen eines Steuerelements im Bereich Steuerelement bearbeiten ändern möchten, klicken Sie auf das Symbol Steuerelement bearbeiten. Klicken Sie auf das Symbol Steuerelement entfernen, um das Steuerelement von der Bereitstellungskonfiguration zu trennen. 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. Auf der Seite Bewerten der Console können Sie testen, ob Ihre Änderungen übernommen wurden.

Steuerelemente für die Bereitstellung inline ansehen

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

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'

Wenn Sie mehrere Bereitstellungseinstellungen inline auflisten möchten, verwenden Sie Controls.list.

Optional können Sie den Parameter pageSize verwenden, um die maximale Anzahl der zurückzugebenden Ergebnisse festzulegen. Wenn mehr Ergebnisse verfügbar sind, enthält die Antwort list 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, geben Sie mit dem Abfrageparameter filter die Bereitstellungskonfigurations-ID 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 und fügen Sie eine Instanz von Control in den Anfragetext ein, um Felder in einer Bereitstellungssteuerung zu aktualisieren. Geben Sie die Felder an, die mit dem Parameter updateMask aktualisiert werden sollen, oder lassen Sie die Richtlinie nicht konfiguriert, 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'

Steuerelemente inline zu Bereitstellungskonfigurationen hinzufügen

Verwenden Sie ServingConfig.addControl, um einer Bereitstellungskonfiguration ein Steuerelement 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.

Steuerelemente inline aus Bereitstellungskonfigurationen entfernen

Verwenden Sie ServingConfig.removeControl, um ein Steuerelement 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.

Steuerelement für die Bereitstellung löschen

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

Bereitstellungssteuerung in der Console löschen

Löschen Sie eine Bereitstellungssteuerung, um sie aus allen Bereitstellungskonfigurationen zu entfernen, in denen sie verwendet wird.

1. Rufen Sie in der Search for Retail-Konsole die Seite Einstellungen auf.
   
   Zur Seite „Einstellungen“

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.

Bereitstellungssteuerung inline löschen

Wenn Sie Bereitstellungseinstellungen inline löschen möchten, verwenden Sie Controls.delete.

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 „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 die Bereitstellungseinstellungen in eine Datei in einem Cloud Storage-Bucket exportieren.

Es gibt zwei Gründe, aus denen Sie Bereitstellungseinstellungen exportieren und importieren sollten:

• Bereitstellungseinstellungen von einem Projekt in ein anderes verschieben

• Bulk-Bearbeitung aller oder einiger Steuerelemente für die Anzeigenbereitstellung Exportieren Sie die Bereitstellungseinstellungen, bearbeiten Sie die exportierte Datei und importieren Sie sie, um sie zu ändern oder hinzuzufügen.

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

So exportieren Sie Bereitstellungseinstellungen:

1. Rufen Sie in der Search for Retail-Konsole die Seite Einstellungen auf.
   
   Zur Seite „Einstellungen“

2. Klicken Sie auf dem Tab Steuerelemente für die Anzeigenbereitstellung auf Steuerelemente für den Export.

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

4. Klicken Sie auf Exportieren.

   Die exportierten Steuerelemente 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 Status des Vorgangs im Fenster Aktivitäten exportieren in der Liste Aktivitäten im Bulk importieren, exportieren, löschen sehen. Öffnen Sie das Fenster Aktivität exportieren. Klicken Sie dazu im Nachrichtenfenster auf Anzeigen oder folgen Sie der Anleitung unter Status für einen bestimmten Integrationsvorgang ansehen.

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 Bereitstellungseinstellungen im Bulk-Verfahren hinzufügen oder ändern möchten, können Sie die Änderungen in einer exportierten Datei mit Steuerelementen vornehmen. Anschließend können Sie sie in das ursprüngliche Projekt oder in ein anderes Projekt importieren.

Informationen zum Importieren von Bereitstellungseinstellungen:

• Sie können eine Kontrolldatei für die Bereitstellung nicht importieren, wenn sie sowohl Steuerelemente für die Suche als auch für Empfehlungen enthält.

• Wenn Sie Bereitstellungseinstellungen importieren, werden alle Bereitstellungseinstellungen in der Datei der Bereitstellungskonfiguration zugeordnet, die Sie beim Import angeben. Wenn eine Bereitstellungssteuerung bereits mit einer anderen Bereitstellungskonfiguration im Projekt verknüpft ist, wird diese Verknüpfung beibehalten.

So importieren Sie Bereitstellungseinstellungen:

1. Bearbeiten und überprüfen Sie eine exportierte Kontrolldatei für die Bereitstellung und platzieren Sie die Datei in einem Cloud Storage-Bucket. Informationen zum Exportieren von Bereitstellungseinstellungen finden Sie in der vorherigen Aufgabe Bereitstellungseinstellungen exportieren.

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

2. Rufen Sie in der Search for Retail-Konsole die Seite Einstellungen auf.
   
   Zur Seite „Einstellungen“

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

4. Im Fenster Auslieferungseinstellungen importieren:

   1. Suchen Sie den Cloud Storage-Bucket und die NDJSON-Datei, die die zu importierenden Steuerelemente enthalten, und wählen Sie sie aus.

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

   3. Prüfen Sie den Importvorschau-Plan. Die erstellten Steuerelemente werden auf dem Tab Neu angezeigt und die zu ändernden Steuerelemente auf dem Tab Geändert.

5. Klicken Sie auf Import (Importieren).

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

6. Nachdem der Importvorgang abgeschlossen ist, können Sie den Vorgangsstatus im Fenster Aktivitätsstatus auf dem Tab Steuerelemente sehen. Öffnen Sie das Fenster Aktivitätsstatus. Klicken Sie dazu im Nachrichtenfenster auf Anzeigen oder folgen Sie der Anleitung unter Status für einen bestimmten Integrationsvorgang ansehen.