Penting: Content API for Shopping dihentikan pada 18 Agustus 2026.

Mulai 1 September 2026, permintaan Content API for Shopping akan mengalami error progresif. Tinjau panduan penghentian penggunaan Content API.

Jika Anda memerlukan waktu tambahan untuk bermigrasi ke Merchant API, ajukan permohonan akses yang diperpanjang ke Content API for Shopping.

Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Panggilan API langsung

Dalam pendekatan untuk berinteraksi dengan Merchant API ini, buat permintaan mentah ke endpoint API secara langsung, biasanya melalui HTTP(S). Anda menangani aspek seperti pembentukan isi permintaan, penetapan header (termasuk autentikasi), dan penguraian respons secara manual.

Langkah 1. Daftarkan diri sebagai pengembang

Untuk menggunakan Merchant API, Anda harus mendaftarkan informasi kontak developer Anda.

Pendaftaran akan melakukan hal berikut:

Membuat kontak teknis untuk akun Merchant Center Anda dengan menetapkan peran API developer kepada pengguna. Hal ini memungkinkan Google mengirimkan info terbaru yang penting, khususnya tentang API dan fitur yang digunakan developer, seperti pengumuman layanan dan informasi tentang fitur baru, yang mungkin kurang menarik bagi non-developer.
Memungkinkan Anda bekerja dengan beberapa akun penjual tanpa harus mendaftar beberapa kali. Saat Anda mendaftar, project ID Google Cloud yang digunakan untuk melakukan autentikasi ke Merchant API akan dikaitkan dengan akun Merchant Center Anda, yang memiliki kontak teknis (API developer). Dengan cara ini, Anda bisa mendapatkan info terbaru yang penting untuk semua akun penjual yang Anda kelola, selama autentikasi dilakukan dengan project Google Cloud yang terdaftar.

Saat mendaftar, perhatikan prasyarat dan batasan yang dijelaskan di Pendaftaran.

Untuk mendaftar menggunakan metode developerRegistration.registerGcp, Anda dapat memulai dengan contoh ini, mengganti {DEVELOPER_EMAIL} dengan alamat email yang sesuai dalam isi permintaan.

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Panggilan yang berhasil akan menampilkan resource DeveloperRegistration, yang mengonfirmasi penautan antara project dan akun Anda.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Langkah 2. Mengelola kontak dan izin developer

Saat Anda mendaftar:

Jika alamat email tersebut milik pengguna di akun Merchant Center, pengguna tersebut akan diberi peran API_DEVELOPER.
Jika alamat email bukan milik pengguna yang ada, undangan akan dikirim ke alamat tersebut. Penerima harus menerima undangan untuk ditambahkan sebagai pengguna baru dengan peran API_DEVELOPER.

Setelah pendaftaran awal, sebaiknya tambahkan beberapa developer dan beri mereka hak akses tambahan.

Langkah 2a. Berikan izin tambahan

Peran API_DEVELOPER diperlukan untuk menerima notifikasi penting, tetapi memiliki izin minimal dalam Merchant Center. Untuk mengizinkan pengguna ini melakukan panggilan API lain atau mengelola setelan di UI Merchant Center, Anda harus memberinya peran tambahan, seperti STANDARD atau ADMIN. Untuk mengetahui informasi selengkapnya, lihat Jenis akses.

Anda dapat memperbarui hak akses pengguna dengan metode accounts.users.patch.

Contoh berikut menunjukkan cara memperbarui pengguna untuk memberinya peran ADMIN dan API_DEVELOPER. Dengan demikian, mereka dapat mengelola akun sepenuhnya dan juga akan menerima komunikasi terkait API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Langkah 2b. Menambahkan developer cadangan

Untuk mencegah gangguan pada akses API jika kontak developer utama Anda keluar dari organisasi, Anda harus menambahkan setidaknya satu developer cadangan.

Anda dapat menambahkan pengguna dengan metode accounts.users.create atau mengupdate pengguna dengan accounts.users.patch. Sebaiknya berikan peran ADMIN dan API_DEVELOPER kepada pengguna ini.

Langkah 3. Membuat sumber data produk utama

Untuk menyisipkan produk, Anda memerlukan sumber data produk utama. Permintaan berikut menunjukkan cara membuat sumber data yang dapat Anda gunakan untuk menyisipkan produk ke akun:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Ganti {ACCOUNT_ID} dengan ID akun Merchant Center yang Anda buat.

Setelah berhasil menjalankan permintaan ini, Anda akan melihat respons berikut:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Salin nilai kolom name. Anda akan memerlukannya untuk menyisipkan produk.

Anda dapat melihat sumber data ini di UI Merchant Center. Untuk mengetahui informasi selengkapnya, lihat Cara menemukan tab Sumber data.

Langkah 4. Masukkan produk

Setelah membuat sumber data, coba sisipkan produk ke dalamnya. Jalankan perintah berikut, dengan memberikan ACCOUNT_ID yang benar. Ganti {DATASOURCE_NAME} dengan nilai yang Anda salin sebelumnya.

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME}
{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "productAttributes": {
    "gender": "MALE",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}