Akun Pengujian di Merchant API

Fitur Akun Pengujian Merchant API menyediakan ruang yang aman dan terisolasi untuk menguji integrasi secara menyeluruh sebelum men-deploy-nya di lingkungan aktif. Dengan menggunakan akun pengujian sandbox, Anda dapat bereksperimen dengan panggilan API, memvalidasi kode, dan mengidentifikasi potensi masalah di awal siklus pengembangan, tanpa memengaruhi data produksi, mengganggu operasi real-time, atau secara tidak sengaja melanggar kebijakan Merchant Center.

Prasyarat

Sebelum dapat membuat dan menggunakan akun pengujian, pastikan Anda memenuhi persyaratan berikut:

  • Akun Merchant Center: Anda harus memiliki akun Merchant Center.
  • Akses Merchant API: Anda harus menjadi pengguna terdaftar Merchant API.

Manfaat Akun Pengujian

Penggunaan akun pengujian menawarkan beberapa keuntungan utama:

  • Penyiapan Sederhana: Penyiapan akun pengujian adalah proses dengan kompleksitas rendah yang memungkinkan Anda memulai pengujian fitur dan integrasi dengan cepat.
  • Integritas dan Keamanan Data: Data produksi tetap terlindungi, dan risiko pelanggaran kebijakan di akun produksi dihilangkan.
  • Efisiensi Pengujian: Anda dapat menguji berbagai skenario dan kasus ekstrem tanpa harus mengelola akun produksi paralel untuk tujuan pengujian.
  • Validasi Penawaran Langsung: Manfaatkan pengecualian otomatis dari klaim dan verifikasi halaman beranda untuk akun pengujian guna menguji penyisipan penawaran dengan cepat. Penawaran disetujui secara default untuk akun pengujian.
  • Simulasi Realistis: Lingkungan mencerminkan perilaku produksi untuk fungsionalitas penting seperti upload produk dan pengelolaan inventaris, sehingga memastikan hasil pengujian dapat diandalkan.
  • Migrasi API yang Lebih Lancar: Akun pengujian memfasilitasi transisi yang lancar dan penuh keyakinan bagi pengguna yang beralih dari Content API ke Merchant API atau dari satu versi API ke versi API lainnya dengan memungkinkan validasi berdampingan.

Cara Membuat Akun Pengujian

Akun pengujian dibuat menggunakan metode kustom tertentu di Merchant API.

Gunakan metode accounts.createTestAccount:

  POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}:createTestAccount
  Content-Type: application/json
  Authorization: Bearer {ACCESS_TOKEN}"

  {
    "account_name": "{TEST_ACCOUNT_NAME}",
    "time_zone": {
      "id": "America/Los_Angeles"
    },
    "language_code": "en-US"
  }

Ganti kode berikut:

  • ACCOUNT_ID: ID Merchant Center Anda.
  • ACCESS_TOKEN: token otorisasi untuk melakukan Panggilan API
  • TEST_ACCOUNT_NAME: nama akun pengujian. Sebaiknya gunakan nama yang bermakna yang menunjukkan bahwa nama tersebut digunakan untuk pengujian. Misalnya, sertakan kata test dalam nama akun pengujian.

Kolom berikut diperlukan saat membuat akun pengujian:

  • time_zone: Zona waktu pelaporan dan tampilan untuk akun.
  • language_code: Kode bahasa BCP-47 untuk akun, seperti en-US.

Panggilan yang berhasil akan menampilkan resource Account yang mencakup accountId unik dan nama resource akun pengujian baru:

  {
    "name": "accounts/{TEST_ACCOUNT_ID}",
    "accountId": "{TEST_ACCOUNT_ID}",
    "accountName": "{TEST_ACCOUNT_NAME}",
    "adultContent": false,
    "testAccount": true,
    "timeZone": {
      "id": "America/Los_Angeles"
    },
    "languageCode": "en-US"
  }

Batasan

Akun pengujian dirancang untuk validasi fungsional dan memiliki batasan tertentu:

  • Jumlah akun pengujian: Anda dapat membuat maksimal 5 akun pengujian per Akun Google. Akun pengujian dihitung dalam batas default akun Merchant Center per Akun Google.
  • Integrasi dengan kuota Merchant API: Dari perspektif kuota API, Merchant API memperlakukan akun pengujian sebagai akun produksi. Akun pengujian tunduk pada kuota yang sama dengan akun produksi. Peningkatan kuota untuk akun pengujian tidak memungkinkan.
  • Akun lanjutan: Anda tidak dapat membuat akun pengujian lanjutan atau mengonversi akun lanjutan menjadi akun pengujian.
  • Tidak ada penayangan publik: Data yang dikirimkan ke akun pengujian tidak akan pernah dipublikasikan di platform Google mana pun, seperti iklan Penelusuran atau Shopping.
  • Endpoint yang dibatasi: Anda tidak dapat menggunakan akun pengujian saat menggunakan fitur tertentu seperti:
  • Batasan Penautan: Anda tidak dapat menautkan akun uji ke akun Google Ads atau Google Profil Bisnis lainnya.
  • Tidak ada pendaftaran untuk akun pengujian: Anda tidak dapat melakukan pendaftaran untuk akun pengujian.

Praktik Terbaik

Sebaiknya ikuti beberapa praktik terbaik saat menggunakan akun pengujian:

  • Pengembangan yang Mengutamakan Sandbox: Selalu validasi fitur integrasi baru di akun pengujian sebelum menerapkannya ke lingkungan produksi Anda.
  • Pengujian Integrasi Otomatis: Gunakan akun pengujian sebagai lingkungan yang stabil untuk menjalankan pengujian regresi otomatis.
  • Penamaan akun pengujian: Gunakan account_name untuk memberi petunjuk tentang tujuan setiap akun pengujian, seperti "Pengujian Migrasi" atau "Akun pengujian integrasi".