Regionsverwaltung migrieren

In diesem Leitfaden wird erläutert, wie Sie Ihre Integration von RegionsService in der Content API for Shopping zu RegionsService in der Unter-API „Konten“ migrieren.

Mit dem Regions-Dienst können Sie benutzerdefinierte geografische Gebiete für Anwendungsfälle wie regionale Preise und Versandüberschreibungen definieren. Sie können Regionen mit Diensten wie RegionalInventory und ShippingSettings verwenden.

Wichtige Unterschiede

  • API-Struktur:Der Regions-Dienst ist jetzt Teil der Unter-API Accounts in der Merchant API (z. B. merchantapi.googleapis.com/accounts/v1/...).
  • Ressourcennamen:Die Merchant API verwendet Ressourcennamen (accounts/{account}/regions/{region}) anstelle separater Parameter merchant_id und region_id im URL-Pfad für die Vorgänge „Abrufen“, „Aktualisieren“ und „Löschen“.
  • AIP-Konformität: Die Methoden der Merchant API folgen den Standardmustern des API Improvement Proposal (z. B. Verwendung von parent für „Auflisten“/„Erstellen“, name für „Abrufen“/„Löschen“ und standardmäßige Verwendung von update_mask).
  • Wrapper-Typen:Für Felder, die zuvor google.protobuf.StringValue oder google.protobuf.BoolValue in der Content API verwendet haben, werden jetzt standardmäßige optional-Felder in der Merchant API verwendet.
  • Neue Funktionen:
    • In der Merchant API wird der Typ RadiusArea in der Ressource Region eingeführt, um Regionen basierend auf einem Radius um einen Punkt zu definieren (zuerst mit der Sichtbarkeit TRUST_TESTER).
    • Batch-Methoden – BatchCreateRegions, BatchUpdateRegions, BatchDeleteRegions – sind verfügbar.
  • Fehlerbehandlung:Fehlercodes und -meldungen liefern genaueres Feedback.

Anfragen

So ändern sich die Anfragemuster:

Posten Content API for Shopping Merchant API Beschreibung
Endpunkt https://shoppingcontent.googleapis.com https://merchantapi.googleapis.com Die Basisdomain ändert sich.
Pfad abrufen /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Die Merchant API verwendet die accounts Unter-API und einen Ressourcen name.
Pfad auflisten /content/v2.1/{merchant_id}/regions /accounts/v1/{parent=accounts/*}/regions Die Merchant API verwendet parent, um das Konto anzugeben.
Pfad erstellen /content/v2.1/{merchant_id}/regions /accounts/v1/{parent=accounts/*}/regions Die Merchant API verwendet parent. region_id ist ein Feld im Anfragetext.
Pfad aktualisieren /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Der Ressourcenname in der Merchant API ist Teil des Objekts region im Text.
Pfad löschen /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Verwendet die Ressource name.

IDs

Ändern Sie die Verwendung von IDs wie folgt:

Posten Content API for Shopping Merchant API Beschreibung
Konto merchant_id (Ganzzahl) account (Ganzzahl, Teil des Strings name oder parent) Die Konto-ID ist im Ressourcennamenstring eingebettet, z. B. accounts/{account}.
Region region_id (String) {region} (String, Teil des Strings name) Die Regions-ID ist im Ressourcennamenstring eingebettet, z. B. accounts/{account}/regions/{region}.
Ressourcenname Wird nicht unbedingt für Anfragen verwendet. name: accounts/{account}/regions/{region} Standard-ID für Anfragen zum Abrufen, Aktualisieren und Löschen.
Übergeordneter Name Wird nicht unbedingt für Anfragen verwendet. parent: accounts/{account} Standard-ID für Anfragen zum Auflisten und Erstellen.

Ressourcen

Die Struktur der Ressource Region wurde geringfügig geändert:

Posten Content API for Shopping Merchant API Beschreibung
Ressourcenkennzeichner region_id (String), merchant_id (int64) name (String): accounts/{account}/regions/{region} Die Merchant API verwendet ein einzelnes Feld name als Ressourcenkennzeichner.
display_name google.protobuf.StringValue optional string Wrapper-Typ entfernt.
radius_area Keine Angabe (–) RadiusArea Mit diesem neuen Typ werden Regionen nach Radius definiert. Enthält region_code, lat_lng, radius, radius_units. Standardmäßig ist die Sichtbarkeit eingeschränkt.
regional_inventory_eligible google.protobuf.BoolValue (nur Ausgabe) optional bool (nur Ausgabe) Wrapper-Typ entfernt.
shipping_eligible google.protobuf.BoolValue (nur Ausgabe) optional bool (nur Ausgabe) Wrapper-Typ entfernt.

Methoden

Ändern Sie die Verwendung von Methoden wie folgt:

Posten Content API for Shopping Merchant API Beschreibung
Region abrufen GetRegion GetRegion Die Anfrage verwendet name.
Region erstellen CreateRegion CreateRegion Die Anfrage übernimmt parent aus der URL, während der Anfragetext enthält das Objekt region und das region_id.
Region aktualisieren UpdateRegion UpdateRegion Die Anfrage verwendet region (einschließlich region.name) und update_mask.
Region löschen DeleteRegion DeleteRegion Die Anfrage verwendet name.
Regionen auflisten ListRegions ListRegions Die Anfrage verwendet parent. page_size und page_token Verhalten ist konsistent.
Batch-Erstellung Keine Angabe (–) BatchCreateRegions Dies ist eine neue Methode.
Batch-Aktualisierung Keine Angabe (–) BatchUpdateRegions Dies ist eine neue Methode.
Batch-Löschung Keine Angabe (–) BatchDeleteRegions Dies ist eine neue Methode.

Umbenannte Felder

Posten Content API for Shopping Merchant API Beschreibung
Konto-ID merchant_id account (Teil von name oder parent) In Ressource name strings integriert. Dies wirkt sich auf Region (Antwort) und Protobuf-Nachrichten aus, die zum Senden von API Anfragen verwendet werden, z. B. CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest und ListRegionsRequest.
Regions-ID region_id region (Teil von name), region_id Für die meisten in name integriert, separates region_id Feld in CreateRegionRequest. Dies wirkt sich auf Region (Antwort) und Protobuf-Nachrichten aus, die zum Senden von API-Anfragen verwendet werden, z. B. CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest und ListRegionsRequest.
Regionsname (Ausgabe) region_id name Das primäre ID-Feld in der Antwort ist jetzt der vollständige Ressourcenname name. Dies wirkt sich auf Region aus.
Anzeigename display_name display_name Der Typ ändert sich von StringValue zu optional string. Dies wirkt sich auf Region aus.
Berechtigungsflags ...eligible ...eligible Der Typ ändert sich von BoolValue zu optional bool. Dies wirkt sich auf Region aus.
Aktualisierungsmaske update_mask update_mask Feldpfade für Region. Dies wirkt sich auf UpdateRegionRequest aus.

Weitere Informationen

Zurück
Migrate homepage management
Weiter
Migrate inventory management