Memigrasikan pengelolaan wilayah

Panduan ini menjelaskan cara memigrasikan integrasi Anda dari RegionsService di Content API for Shopping ke RegionsService dalam sub-API Akun.

Layanan Wilayah memungkinkan Anda menentukan area geografis kustom untuk kasus penggunaan seperti penggantian harga dan pengiriman regional. Anda dapat menggunakan region dengan layanan seperti RegionalInventory dan ShippingSettings.

Perbedaan utama

  • Struktur API: Layanan Regions kini menjadi bagian dari sub-API Accounts di Merchant API (misalnya, merchantapi.googleapis.com/accounts/v1/...).
  • Nama resource: Merchant API menggunakan nama resource (accounts/{account}/regions/{region}) dan bukan parameter merchant_id dan region_id terpisah di jalur URL untuk operasi Get, Update, dan Delete.
  • Kepatuhan AIP: Metode Merchant API mengikuti pola Proposal Peningkatan API standar (seperti penggunaan parent untuk List/Create, name untuk Get/Delete, dan penggunaan update_mask standar).
  • Jenis wrapper: Kolom yang sebelumnya menggunakan google.protobuf.StringValue atau google.protobuf.BoolValue di Content API kini menggunakan kolom optional standar di Merchant API.
  • Fitur baru:
    • Merchant API memperkenalkan jenis RadiusArea dalam resource Region untuk menentukan wilayah berdasarkan radius di sekitar suatu titik (awalnya dengan visibilitas TRUST_TESTER).
    • Metode batch - BatchCreateRegions, BatchUpdateRegions, BatchDeleteRegions - tersedia.
  • Penanganan error: Kode dan pesan error memberikan masukan yang lebih spesifik.

Permintaan

Berikut cara pola permintaan berubah:

Item Content API for Shopping Merchant API Deskripsi
Endpoint https://shoppingcontent.googleapis.com https://merchantapi.googleapis.com Domain dasar berubah.
Dapatkan Jalur /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Merchant API menggunakan sub-API accounts dan resource name.
Jalur Daftar /content/v2.1/{merchant_id}/regions /accounts/v1/{parent=accounts/*}/regions Merchant API menggunakan parent untuk menentukan akun.
Buat Jalur /content/v2.1/{merchant_id}/regions /accounts/v1/{parent=accounts/*}/regions Merchant API menggunakan parent. region_id adalah kolom di isi permintaan.
Perbarui Jalur /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Nama resource di Merchant API adalah bagian dari objek region di isi.
Hapus Jalur /content/v2.1/{merchant_id}/regions/{region_id} /accounts/v1/{name=accounts/*/regions/*} Menggunakan resource name.

Pengenal

Ubah penggunaan ID Anda sebagai berikut:

Item Content API for Shopping Merchant API Deskripsi
Akun merchant_id (bilangan bulat) account (bilangan bulat, bagian dari string name atau parent) Temukan ID akun yang disematkan dalam string nama resource, misalnya, accounts/{account}.
Wilayah region_id (string) {region} (string, bagian dari string name) Temukan ID region yang disematkan dalam string nama resource, misalnya, accounts/{account}/regions/{region}.
Nama Resource Tidak digunakan secara ketat untuk permintaan. name: accounts/{account}/regions/{region} ID standar untuk permintaan Get/Update/Delete.
Nama Orang Tua Tidak digunakan secara ketat untuk permintaan. parent: accounts/{account} ID standar untuk permintaan List/Create.

Resource

Struktur resource Region memiliki perubahan kecil:

Item Content API for Shopping Merchant API Deskripsi
ID Resource region_id (string), merchant_id (int64) name (string): accounts/{account}/regions/{region} Merchant API menggunakan satu kolom name sebagai ID resource.
display_name google.protobuf.StringValue optional string Jenis wrapper dihapus.
radius_area Tidak Tersedia (T/A) RadiusArea Jenis baru ini menentukan wilayah berdasarkan radius. Mencakup region_code, lat_lng, radius, radius_units. Secara default, visibilitas dibatasi.
regional_inventory_eligible google.protobuf.BoolValue (hanya output) optional bool (hanya output) Jenis wrapper dihapus.
shipping_eligible google.protobuf.BoolValue (hanya output) optional bool (hanya output) Jenis wrapper dihapus.

Metode

Ubah penggunaan metode Anda sebagai berikut:

Item Content API for Shopping Merchant API Deskripsi
Dapatkan Wilayah GetRegion GetRegion Permintaan menggunakan name.
Buat Wilayah CreateRegion CreateRegion Permintaan mengambil parent dari URL, sementara isi permintaan mencakup objek region dan region_id.
Perbarui Wilayah UpdateRegion UpdateRegion Permintaan menggunakan region (yang harus menyertakan region.name) dan update_mask.
Hapus Wilayah DeleteRegion DeleteRegion Permintaan menggunakan name.
Daftar Wilayah ListRegions ListRegions Permintaan menggunakan parent. Perilaku page_size dan page_token konsisten.
Buat Batch T/A BatchCreateRegions Ini adalah metode baru.
Pembaruan Batch T/A BatchUpdateRegions Ini adalah metode baru.
Penghapusan Batch T/A BatchDeleteRegions Ini adalah metode baru.

Kolom yang diganti namanya

Item Content API for Shopping Merchant API Deskripsi
ID Akun merchant_id account (bagian dari name atau parent) Terintegrasi ke dalam string resource name. Hal ini memengaruhi Region (respons) dan pesan protobuf yang digunakan untuk membuat permintaan API, seperti CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest dan ListRegionsRequest.
ID wilayah region_id region (bagian dari name), region_id Diintegrasikan ke dalam name untuk sebagian besar, kolom region_id terpisah di CreateRegionRequest. Hal ini memengaruhi Region (respons) dan pesan protobuf yang digunakan untuk membuat permintaan API, seperti CreateRegionRequest, GetRegionRequest, UpdateRegionRequest, DeleteRegionRequest dan ListRegionsRequest.
Nama Wilayah (Output) region_id name Kolom ID utama dalam respons kini adalah name resource lengkap. Hal ini memengaruhi Region.
Nama Tampilan display_name display_name Jenisnya berubah dari StringValue menjadi optional string. Hal ini memengaruhi Region.
Tanda kelayakan ...eligible ...eligible Jenisnya berubah dari BoolValue menjadi optional bool. Hal ini memengaruhi Region.
Perbarui Masker update_mask update_mask Jalur kolom Region. Hal ini memengaruhi UpdateRegionRequest.

Pelajari lebih lanjut

Sebelumnya
Migrate homepage management
Berikutnya
Migrate inventory management