/api/v4/connected-accounts/disconnect-googleMemutuskan koneksi akun Google
Memutuskan seluruh koneksi akun Google Business Profile yang terhubung ke akun Listings API Anda.
Parameter
Body
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| input | object | wajib | Wrapper object. The entire request body must be nested under `input`. |
| input.connectedAccountId | string | wajib | UUID of the connected Google account to disconnect. The whole account is disconnected. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" }}Respons
200Request accepted. `success: true` confirms the disconnect was processed.
{ "data": { "gmbBulkDisconnect": { "success": true } }}400Bad request, the body was not wrapped in `input`, or `connectedAccountId` was omitted (error message: `Field value.connectedAccountId of required type String! was not provided`).
401Unauthenticated, missing or invalid API key.
Memutuskan hubungan antara akun Google Business Profile yang terhubung dan akun Listings API Anda. Setelah koneksi diputuskan, profil bisnis yang disinkronkan melalui akun tersebut berhenti menerima pembaruan dari Listings API.
Struktur permintaan. Isi permintaan harus dibungkus dalam objek input yang hanya memiliki field connectedAccountId. Operasi ini berlaku secara menyeluruh: koneksi seluruh akun Google beserta setiap lokasi yang terhubung melaluinya akan diputuskan. Tidak ada field locationIds; field tersebut ditolak oleh skema. Untuk memutuskan koneksi profil bisnis pada satu lokasi sambil tetap mempertahankan koneksi akun, gunakan endpoint disconnect-listing.
Kasus penggunaan: penghentian layanan secara menyeluruh saat klien berhenti. Kirim connectedAccountId untuk memutuskan seluruh koneksi dalam satu panggilan. Ini adalah cara yang tepat untuk mencabut akses Listings API setelah pelanggan berhenti menggunakan layanan atau mengalihkan kepemilikan akun Google mereka.
Kasus penggunaan: memutuskan koneksi yang bermasalah. Jika koneksi Google mengalami kesalahan kredensial yang tidak dapat diatasi dengan autentikasi ulang, putuskan koneksinya di sini dan buat tautan baru dengan endpoint connect-google. Untuk akun Facebook, gunakan endpoint disconnect-facebook, yang menerima struktur permintaan yang sama. Perhatikan bahwa respons success: true dikembalikan bahkan untuk connectedAccountId yang tidak dikenal, jadi anggap keberhasilan sebagai "permintaan telah diproses", bukan bukti bahwa koneksi aktif telah dihapus; konfirmasikan keadaan akun dengan GET /connected-accounts jika Anda memerlukan kepastian.
Endpoint ini mengubah koneksi aktif dan mencabut akses Listings API ke Google. Struktur permintaan dan contoh respons di atas didokumentasikan berdasarkan spesifikasi API; panggilan tersebut tidak dijalankan terhadap data produksi.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/disconnect-google' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "connectedAccountId": "d2397854-52c2-41d7-95f1-b90cba16498d" } }'