Merchant API v1beta dihentikan dan ditutup pada 28 Februari 2026. Untuk mengetahui langkah-langkah transisi ke versi stabil terbaru, lihat Bermigrasi dari v1beta ke v1.

Panggilan API langsung

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

Langkah 1. Daftarkan diri sebagai pengembang

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

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 update penting khusus tentang API dan fitur yang digunakan pengembang, seperti pengumuman layanan dan informasi tentang fitur baru, yang mungkin kurang menarik bagi non-pengembang.
Memungkinkan Anda menggunakan beberapa akun penjual tanpa harus mendaftar beberapa kali. Saat Anda mendaftar, ID project Google Cloud yang digunakan untuk melakukan autentikasi ke Merchant API akan dikaitkan dengan akun Merchant Center Anda, yang memiliki kontak teknis (API developer). Dengan begitu, Anda bisa mendapatkan update 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 developerRegistration.registerGcp metode, Anda dapat memulai dengan contoh ini, mengganti {DEVELOPER_EMAIL} dengan alamat email yang sesuai di 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 link antara project dan akun Anda.

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

Langkah 2. Mengelola kontak dan izin pengembang

Saat Anda mendaftar:

Jika alamat email 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 pengembang dan berikan hak akses tambahan kepada mereka.

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 lainnya atau mengelola setelan di UI Merchant Center, Anda harus memberikan peran tambahan kepada mereka, 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 memberikan peran ADMIN dan API_DEVELOPER kepada mereka. Hal ini memungkinkan mereka mengelola akun sepenuhnya dan mereka 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. Tambahkan pengembang cadangan

Untuk mencegah akses API Anda terganggu jika kontak pengembang utama keluar dari organisasi Anda, Anda harus menambahkan setidaknya satu pengembang cadangan.

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

Langkah 3. Buat 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 Anda:

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"
}