Halaman ini diterjemahkan oleh Cloud Translation API.

Ringkasan Merchant API

Anda dapat menggunakan Merchant API untuk

Mengelola tampilan bisnis dan produk Anda di Google.
Dapatkan akses terprogram ke data, insight, dan kemampuan unik.
Kembangkan bisnis Anda dan jangkau lebih banyak pelanggan di Google.

Merchant API dapat mengelola akun Merchant Center yang besar atau rumit. Kasus penggunaan umum meliputi:

Pengelolaan akun otomatis
Pengelolaan produk otomatis
Pengelolaan inventaris otomatis
Pengelolaan laporan otomatis tentang performa dan analisis pasar

Merchant API memungkinkan Anda membuat dan mengelola beberapa sumber data, sehingga memungkinkan pengorganisasian informasi yang lebih baik tentang produk, promosi, dan ulasan. Dengan Merchant API, Anda dapat mengelola produk dengan cara yang melengkapi metode upload data produk lainnya seperti file dan feed otomatis. Merchant API juga memungkinkan Anda menjalankan beberapa permintaan individual secara paralel.

Merchant API adalah desain ulang Content API for Shopping. API ini terdiri dari beberapa sub-API.

Yang baru di Merchant API

Berikut beberapa alasan untuk mengupgrade ke Merchant API:

Pengelolaan data inventaris yang lebih baik dengan diperkenalkannya metode baru berikut:
Memungkinkan pengelolaan sumber data tambahan melalui pembuatan dan pengambilan sumber data tambahan, serta dengan menautkan sumber data tambahan ke sumber data utama.
Mengaktifkan notifikasi untuk perubahan pada data produk Anda, sehingga Anda tidak perlu melakukan pengambilan data secara berkala karena Anda akan diberi tahu saat status produk berubah.
Memperkenalkan resource accounts.autofeedSettings dan metode untuk mengambil dan memperbarui setelan feed otomatis.
Memperkenalkan upload ulasan produk dan ulasan penjual.
Memperkenalkan resource accounts.productInputs untuk menyederhanakan resource accounts.products.
Memungkinkan pembaruan data produk bersama dengan metode upload data lainnya seperti file.
Tabel NonProductPerformanceView baru untuk data performa non-produk, seperti informasi tentang traffic masuk ke situs retailer
Desain modular dengan peningkatan fitur yang terisolasi dan lebih sering
Dokumentasi dan contoh kode yang diperbarui
Penyelarasan yang lebih baik dengan saran peningkatan API Google
Peningkatan dukungan dan komunikasi untuk developer melalui Pendaftaran Developer.
Memperbarui dokumentasi dan contoh kode.
Peningkatan dukungan dan komunikasi untuk developer melalui Pendaftaran Developer.

Sebelum memulai

Untuk menjalankan permintaan Merchant API, Anda harus memiliki hal berikut:

Akun Merchant Center: Ini adalah akun yang akan Anda kueri, perbarui, dan upload datanya. Pastikan Anda memiliki izin yang diperlukan untuk mengelola produk dan inventaris di akun ini.
Project Google Cloud: Gunakan project untuk mendapatkan akses API ke akun Anda.
Link dari akun Merchant Center Anda ke project Google Cloud. Buat link dengan memanggil metode Pendaftaran Developer. Anda akan menggunakan akun ini dan pengguna ini untuk komunikasi terkait integrasi API, survei, dan peluang.

Tautkan akun Merchant Center Anda ke project Google Cloud dengan mendaftar sebagai developer. Pengguna dengan peran developer API akan menerima komunikasi API, termasuk pengumuman layanan wajib, survei developer, dan peluang.

Autentikasi dengan Merchant API

Anda dapat menggunakan opsi berikut untuk autentikasi:

Anda dapat membuat client ID dan rahasia OAuth 2.0 untuk aplikasi Anda. ID dan rahasia tersebut kemudian dapat digunakan untuk membuat kredensial OAuth 2.0 yang diperlukan dalam panggilan API ke akun Merchant Center.
Anda dapat membuat akun layanan dan mendownload kunci pribadinya untuk melakukan panggilan API.

ID akun dan produk

Merchant API menggunakan nama resource, bukan ID untuk identifikasi. Contoh nama resource untuk produk dapat berupa accounts/123456/products/en~US~sku123, dengan 123456 adalah ID unik akun dan en~US~sku123 adalah ID unik produk.

Format URL permintaan

Untuk mengoperasikan resource, kirim permintaan ke URL dalam format berikut:

https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME}:{METHOD}

Bagian :{METHOD} dihilangkan untuk metode standar seperti list dan get.

Misalnya, permintaan berikut menghapus inventaris regional:

DELETE https://merchantapi.googleapis.com/inventories/v1/accounts/123456/products/online~en~US~sku123/regionalInventories/456

Untuk membuat resource, gunakan nama resource dari resource induk dan URL ini:

POST https://merchantapi.googleapis.com/{SUB_API}/{VERSION}/{RESOURCE_NAME_OF_PARENT}/{RESOURCE}

Misalnya, permintaan berikut menunjukkan cara membuat wilayah untuk accounts/123456:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/123456/regions?regionId=WA HTTP/1.1

{
  "displayName": "Washington",
  "name": "Washington",
  "postalCodeArea": {
    "postalCodes": [
      {
        "begin": "98039",
        "end": "98118"
      }
    ],
    "regionCode": "US"
  }
}

Untuk mengetahui detail selengkapnya tentang layanan tertentu, lihat dokumentasi referensi Merchant API.

Mulai menggunakan Merchant API

Untuk melihat cara kerja Merchant API dengan cepat dan mencoba mengupload produk contoh, lihat Mulai menggunakan Merchant API.

Menggunakan gRPC atau REST

Merchant API mendukung gRPC dan REST. Berikut adalah dua cara untuk melakukan panggilan Merchant API:

gRPC (direkomendasikan)	REST
Buat isi permintaan sebagai buffer protokol. Kirim isi permintaan ke server dengan HTTP/2. Lakukan deserialisasi respons ke buffer protokol. Menginterpretasi hasil.	Buat isi permintaan sebagai objek JSON. Kirim ke server menggunakan HTTP 1.1. Deserialisasi respons sebagai objek JSON. Menginterpretasi hasil.

Menggunakan library klien dan contoh kode

Setiap sub-API memiliki library klien untuk membantu Anda memulai. Contoh kode dapat membantu Anda mulai menulis kode di Java, PHP, dan Python. Untuk mengetahui informasi selengkapnya, lihat Contoh untuk Merchant API.

Dapatkan bantuan

Untuk mengetahui informasi tentang cara mendapatkan dukungan, lihat Mendapatkan bantuan terkait Merchant API.

Beri masukan

Untuk memberikan masukan, kirimkan salah satu hal berikut:

Fitur API: Pilih opsi Kirim Masukan di bagian Apa Masalah/Pertanyaan Anda? pada formulir masukan.
Dokumentasi: Gunakan rating jempol di halaman dan tombol Kirim masukan.
Contoh dan library: Buat masalah di repositori GitHub untuk contoh kode.

Langkah berikutnya

Untuk mengetahui informasi tentang kompatibilitas mundur, lihat Kompatibilitas Content API for Shopping.
Untuk mengetahui lebih lanjut fitur utama Merchant API, lihat panduan di menu navigasi kiri.
Untuk mengetahui informasi tentang resource dan layanan yang tersedia, lihat Dokumentasi referensi.