Mulai menggunakan Merchant API

Halaman ini menjelaskan cara membuat akun Merchant Center dan mengupload produk contoh menggunakan Merchant API.

Sebelum memulai

Aktifkan Merchant API di project Google Cloud Anda.

Jika Anda menggunakan integrasi API di Apps Script menggunakan Layanan Konten Shopping, project Google Cloud default akan dibuat dan layanan Merchant API diaktifkan secara otomatis. Namun, Anda tetap harus menyelesaikan pendaftaran Developer satu kali sebelum menggunakan Merchant API. Untuk mengetahui informasi selengkapnya, lihat Menggunakan Layanan Merchant API di Apps Script.

Buka Google Cloud

Buat akun

Untuk menggunakan Merchant API, Anda harus memiliki akun Merchant Center. Untuk membuatnya, lihat Mulai menggunakan Merchant Center.

Buka Merchant Center

Daftarkan diri sebagai pengembang

Untuk menggunakan Merchant API, Anda harus membuat penautan antara project Google Cloud dan akun Merchant Center utama Anda. Pendaftaran satu kali ini diperlukan untuk setiap project Google Cloud yang Anda gunakan dengan Merchant API.

Mendaftar sebagai developer akan menghasilkan dua hal:

  • Hal ini menautkan project Google Cloud Anda ke akun Merchant Center utama Anda, sehingga membuat koneksi formal.
  • Kontak teknis dibuat dengan menetapkan peran API_DEVELOPER kepada pengguna di akun Merchant Center Anda. Dengan begitu, Google dapat mengirimkan update penting tentang API kepada Anda, seperti pengumuman layanan dan informasi tentang fitur baru.

Mendaftarkan project Google Cloud Anda

Untuk mendaftar, panggil metode developerRegistration.registerGcp. Panggilan ini menautkan project Google Cloud yang Anda gunakan untuk melakukan panggilan dengan akun Merchant Center yang Anda tentukan dalam permintaan.

Di isi permintaan, Anda harus memberikan alamat email developer untuk digunakan sebagai kontak teknis. Alamat ini harus dikaitkan dengan Akun Google (akun Google Workspace atau akun Gmail), misalnya sampleuser@gmail.com. Akun layanan tidak dapat digunakan karena merupakan akun non-manusia yang ditujukan untuk akses terprogram, bukan komunikasi dengan developer.

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

Berikut adalah contoh 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"
  ]
}

Mengelola kontak dan izin developer

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

Memberikan 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 perlu memberikan peran tambahan kepada pengguna tersebut, 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. 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"
  ]
}

Menambahkan developer cadangan

Untuk mencegah terganggunya akses API Anda 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 memperbarui pengguna yang sudah ada dengan metode accounts.users.patch. Sebaiknya berikan pengguna ini peran ADMIN dan API_DEVELOPER.

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 Anda:

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

{
  "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.

Masukkan produk

Untuk memasukkan produk contoh ke akun Anda, jalankan permintaan berikut:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Ganti {DATASOURCE_NAME} dengan nilai yang Anda salin sebelumnya.

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

{
  "name": "accounts/{ACCOUNT_ID}/productInputs/en~US~tshirt-123",
  "product": "accounts/{ACCOUNT_ID}/products/en~US~tshirt-123",
  "offerId": "tshirt-123",
  "contentLanguage": "en",
  "feedLabel": "US",
  "attributes": {
    "brand": "New brand",
    "gender": "Male"
  }
}

ID produk untuk produk yang baru dibuat adalah en~US~tshirt-123. Anda dapat menggunakan metode accounts.products.get untuk mengambil detail tentang produk ini. Anda juga dapat menggunakan UI Merchant Center untuk melihat produk ini. Lihat Melihat data produk.

Sebelumnya
Design
Berikutnya
Overview