Buat lokasi dari profil bisnis akun terhubung

Membuat lokasi Listings API baru dengan mengambil data bisnis dari profil bisnis yang sudah ada di akun Google Business Profile atau Facebook yang terhubung. Profil bisnis tersebut harus sudah ada di akun itu (diambil melalui POST /connected-accounts/connected-account-listings) dan belum boleh ditautkan ke lokasi Listings API lain.

Struktur permintaan. Isi permintaan harus dibungkus dalam objek input dengan dua field wajib: connectedAccountId (akun pemilik profil bisnis) dan connectedAccountListingId (profil bisnis tertentu yang akan diimpor). Tidak ada field listingId; field tersebut ditolak oleh skema.

Untuk profil bisnis Google, API mengimpor nama, alamat, koordinat, nomor telepon, situs web, deskripsi, jam operasional reguler dan khusus, kategori utama dan tambahan, tanggal pembukaan, kode toko, dan zona waktu. Metode pembayaran dan tautan profil media sosial diperoleh dari atribut Google pada profil bisnis tersebut. Atribut Google selain metode pembayaran dan tautan media sosial dibaca tetapi tidak disimpan. Untuk Facebook, API mengimpor nama, lokasi, jam operasional, kategori, deskripsi, dan informasi kontak.

Lokasi baru secara otomatis ditautkan ke akun terhubung yang menjadi sumbernya. Untuk impor dari Google, data tidak dikirim ulang ke Google. Profil sumber impor dibiarkan sebagaimana adanya, dan profil bisnisnya melaporkan syncStatus: IN_PROGRESS hingga POST /api/v4/locations/update pertama Anda menerbitkan data ke profil tersebut. Semua platform publikasi lain diproses seperti biasa: item pesanan dibuat dan lokasi dikirim ke setiap situs lain yang diaktifkan pada akun.

Endpoint ini tidak menerima cakupan situs maupun opsi untuk menonaktifkan pengiriman, sehingga lokasi selalu dibuat untuk seluruh platform publikasi pada akun Anda. Untuk membatasinya ke satu platform publikasi, tetapkan enabledSiteIds pada lokasi baru melalui POST /api/v4/locations/update segera setelah lokasi dibuat. Kirim pembaruan tersebut segera setelah lokasi dibuat: item pesanan untuk platform publikasi lain dibuat tidak lama setelah pembuatan lokasi, dan item yang sudah dibuat tidak dibatalkan oleh pembaruan tersebut.

Kasus penggunaan: penyediaan lokasi secara massal selama penyiapan awal. Sebuah agensi menghubungkan akun Google milik klien yang mengelola 40 gerai yang belum pernah dimasukkan oleh agensi tersebut ke Listings API. Alih-alih membuat setiap lokasi secara manual, ambil daftar profil bisnis pada akun tersebut dan panggil endpoint ini satu kali untuk setiap connectedAccountListingId guna membuat seluruh 40 lokasi Listings API dengan data yang sudah diisi dari Google, lalu lakukan penagihan dan kelola lokasi tersebut seperti biasa.

success: true berarti lokasi berhasil dibuat dan locationId adalah ID lokasi tersebut dalam basis data. Jika gagal, success bernilai false, locationId bernilai null, dan errors memuat alasan terstruktur yang dilengkapi kode, misalnya { "code": "SY81067", "message": "Invalid connected account listing ID" } ketika connectedAccountListingId tidak dapat ditemukan. Kasus umum lainnya adalah profil bisnis yang sudah terhubung ke lokasi lain, atau akun yang kredensialnya telah kedaluwarsa dan harus dihubungkan kembali melalui endpoint connect-google atau connect-facebook. Untuk menautkan profil bisnis ke lokasi yang sudah ada alih-alih membuat lokasi baru, gunakan endpoint connect-listing.