Kompatibilitas Content API for Shopping

Anda dapat menggunakan panduan ini untuk mengintegrasikan Merchant API dengan implementasi Content API for Shopping yang sudah ada.

Mulai

Lihat desain API Merchant untuk mengetahui detail tentang Merchant API, dan sub-API-nya.

Untuk mulai menggunakan Merchant API, ubah URL permintaan Anda menjadi URL berikut format:

https://merchantapi.googleapis.com/{sub-API}/{version}/{resource name}/{service}:{method}…

Lihat panduan memulai dan referensi Merchant API untuk mengetahui informasi selengkapnya.

Dukungan gRPC

Merchant API mendukung gRPC dan REST. Anda dapat menggunakan gRPC untuk Merchant API dan REST untuk Content API for Shopping secara bersamaan baik.

Library klien Merchant API memerlukan gRPC.

Lihat menggunakan gRPC untuk mengetahui informasi selengkapnya tidak akurat atau tidak sesuai.

Kompatibilitas

Panduan ini menjelaskan perubahan umum yang berlaku untuk seluruh Merchant API. Lihat panduan berikut untuk perubahan pada fitur tertentu:

• Memigrasikan pengelolaan akun
• Memigrasikan setelan pengiriman
• Memigrasikan pengelolaan produk
• Memigrasikan pengelolaan sumber data
• Memigrasikan pengelolaan inventaris
• Memigrasikan pengelolaan promosi
• Memigrasikan pengelolaan pelaporan
• Memigrasikan pengelolaan sumber konversi
• Memigrasikan pengelolaan kemitraan feed lokal

Merchant API dirancang untuk berfungsi bersama Content API for Shopping yang sudah ada v2.1.

Misalnya, Anda dapat menggunakan Merchant Inventories API bersama Inventaris Content API for Shopping v2.1 dan Implementasi products. Anda mungkin menggunakan Content API for Shopping untuk mengupload konten lokal baru produk (yang Anda jual di toko lokal), lalu gunakan Merchant Inventories API LocalInventory untuk mengelola informasi di dalam toko untuk produk tersebut.

Catatan: Kami tidak dapat menjamin kompatibilitas mundur penuh untuk fitur serupa antara Content API for Shopping dan Merchant API karena peningkatan desain Anda. Misalnya, nama kolom atau ketersediaan metode mungkin berbeda untuk resource yang sama di Content API for Shopping dan API Penjual.

Permintaan batch

Merchant API tidak mendukung metode customBatch yang ditampilkan dalam Content API for Shopping. Sebagai gantinya, lihat Mengirim batch permintaan. Jika Anda menggunakan customBatch, dan memerlukan fitur ini untuk Merchant API, beri tahu kami alasannya masukan.

Pengenal

Agar selaras dengan prinsip peningkatan API Google, kami telah melakukan beberapa perubahan pada ID untuk resource Merchant API.

nama menggantikan Id

Semua resource Merchant API menggunakan kolom name sebagai ID uniknya.

Berikut adalah contoh cara menggunakan kolom name dalam panggilan Anda:

POST https://merchantapi.googleapis.com/inventories/v1beta/{parent}/regionalInventories:insert

Kolom name baru ini ditampilkan sebagai ID resource untuk semua operasi baca dan menulis panggilan di Merchant API.

Nilai yang ditampilkan di kolom name menggunakan format ID baru.

Penting: Sebaiknya gunakan nilai dari kolom name langsung di kolom panggilan, alih-alih mengurai atau membuat nama resource secara manual untuk menghindari terkait.

Misalnya, implementasikan metode getName() untuk mengambil name dari resource, dan simpan output sebagai variabel, bukan membuat name dari ID penjual dan resource Anda sendiri.

Format ID baru

Catatan: Merchant API akan menampilkan ID tanpa nilai channel hingga November 13 2023. Setelah 13 November, semua panggilan akan menampilkan ID resource lengkap. Anda harus menggunakan ID resource lengkap, termasuk channel, dalam panggilan Anda paling lambat 1 Februari, 2024.

Di Merchant API, ID resource menggunakan format berikut: channel~language~feedLabel~offerId

Resource Content API menggunakan :, bukan ~, di antara setiap nilai dalam ID: channel:language:feedLabel:offerId

Semua panggilan Merchant API menampilkan format baru dengan ~ di antara nilai ke ID. Sebaiknya simpan format baru dari respons dan gunakan dalam panggilan di masa mendatang.

kolom induk untuk resource turunan

Di Merchant API, semua resource turunan memiliki kolom parent. Anda dapat menggunakan kolom parent untuk menentukan name resource yang akan disisipkan turunan, alih-alih meneruskan seluruh resource induk. Anda juga dapat menggunakan parent kolom dengan metode list untuk mencantumkan resource turunan dari parent tersebut.

Misalnya, untuk mencantumkan inventaris lokal untuk produk tertentu, tentukan name produk di bagian parent untuk atribut list . Dalam hal ini, product yang diberikan adalah parent dari LocalInventory resource yang ditampilkan.

Jenis

Berikut adalah beberapa jenis umum yang dibagikan di seluruh sub-API Merchant API.

Harga

Berikut ini yang diubah untuk Price dalam paket Merchant Common:

	Content API	API Penjual
Kolom jumlah	value:string	amountMicros:int64
Kolom mata uang	currency:string	currencyCode:string

Jumlah Price sekarang dicatat dalam mikro, dengan 1 juta mikro setara dengan satuan standar mata uang.

Di Content API for Shopping, Price adalah angka desimal dalam bentuk {i>string<i}.

Nama kolom jumlah telah diubah dari value menjadi amountMicros

Nama kolom mata uang telah diubah dari currency menjadi currencyCode. Tujuan Google tetap menggunakan format ISO 4217.