/api/v4/locations/create/gmb-listingMembuat profil bisnis GMB untuk suatu lokasi
Membuat profil bisnis Google Business Profile baru untuk lokasi Listings API yang sudah ada dan menautkannya ke akun Google yang terhubung.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| input | object | wajib | Wrapper object. The entire request body must be nested under `input`. |
| input.locationId | string | wajib | Base64-encoded location Relay ID (e.g. `TG9jYXRpb246MTgwMDI4OQ==`) of the location to create the Google listing for. |
| input.connectedAccountId | string | wajib | UUID of the connected Google account the new listing should be created under. Taken from `GET /connected-accounts`. |
| input.folderId | string | opsional | Google account group to create the listing inside, as the `accounts/{id}` string from the folders endpoint. Omit to create it at the account root. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5" }}Respons
200Request accepted. `success: true` means GMB listing creation was initiated.
{ "data": { "createGmbListingForLocation": { "clientMutationId": null, "success": true, "errors": null } }}400Bad request, the body was not wrapped in `input` (error message: `Variable "$input" of required type "CreateGmbListingForLocationInput!" was not provided`).
401Unauthenticated, missing or invalid API key.
Membuat profil bisnis Google Business Profile yang sepenuhnya baru untuk lokasi Listings API dan mengaitkannya dengan akun Google yang terhubung. Gunakan ini jika lokasi tersebut belum memiliki profil bisnis Google sama sekali, berbeda dengan connect-listing, yang menautkan lokasi Listings API ke profil bisnis yang sudah ada di akun Google.
Struktur permintaan. Isi permintaan harus dibungkus dalam objek input dengan dua field wajib: locationId (Relay ID lokasi yang dikodekan dalam base64) dan connectedAccountId (akun Google tempat profil bisnis akan dibuat). folderId bersifat opsional; sertakan nilai ini untuk menempatkan profil bisnis baru dalam grup akun Google tertentu, dengan mengambil nilainya tanpa perubahan dari Daftar folder. Pengiriman isi permintaan datar tanpa pembungkus akan ditolak dengan status HTTP 400.
Pembuatan berlangsung secara asinkron: success: true berarti permintaan telah diterima, bukan berarti profil bisnis langsung ditayangkan. Google meninjau profil baru sebelum profil tersebut dipublikasikan.
Kasus penggunaan: menyiapkan kehadiran di Google untuk gerai yang benar-benar baru. Klien membuka lokasi baru yang belum memiliki Google Business Profile. Buat lokasi Listings API, hubungkan akun Google klien, lalu panggil endpoint ini dengan ID lokasi dan connectedAccountId agar Listings API mengirimkan profil bisnis baru ke Google di akun tersebut. Setelah itu, periksa profil bisnis lokasi tersebut secara berkala untuk memantau peralihan statusnya dari tertunda menjadi terverifikasi.
Lokasi harus sudah memiliki informasi bisnis yang valid (nama, alamat, telepon) sebelum profil bisnis dapat dibuat, dan setiap lokasi hanya dapat memiliki satu profil bisnis Google. Jika terjadi kegagalan, errors menjelaskan penyebabnya, biasanya karena lokasi tidak memiliki field wajib, sudah memiliki profil bisnis Google, telah diarsipkan, atau akun yang terhubung tidak aktif. Hubungkan kembali akun yang koneksinya sudah tidak berlaku dengan endpoint connect-google. Perhatikan bahwa endpoint saat ini mengembalikan success: true meskipun connectedAccountId bukan akun Google yang benar-benar ada dan terhubung, jadi pastikan profil bisnis benar-benar muncul (melalui profil bisnis lokasi tersebut) alih-alih hanya mengandalkan success.
curl -X POST 'https://listingsapi.com/api/v4/locations/create/gmb-listing' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "locationId": "TG9jYXRpb246MTgwMDI4OQ==", "connectedAccountId": "4f712c17-4f95-42dd-90f4-97171a2e67b5" } }'