/api/v4/connected-accounts/connect-googleHubungkan akun Google
Mengembalikan URL OAuth untuk menghubungkan akun Google Business Profile 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.successUrl | string | wajib | URL the user is redirected to after they successfully authorize Google. Must be an absolute https URL you control. |
| input.errorUrl | string | wajib | URL the user is redirected to if they cancel or the authorization fails. Must be an absolute https URL you control. |
Contoh permintaan
Body siap tempel. Ganti ID dan nilai placeholder dengan milik Anda.
{ "input": { "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches", "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect" }}Respons
200OAuth URL generated successfully. Redirect the user to `url` to begin the Google authorization flow. The `url` shown is a placeholder; send the user to the `url` returned in your own response.
{ "data": { "bulkConnectLinkForGoogle": { "errors": null, "success": true, "url": "https://connect.example.com/oauth?token=8f3c1d92-..." } }}400Bad request, the body was not wrapped in `input`, or `successUrl`/`errorUrl` was omitted (error message: `Variable "$input" of required type "GoogleOauthBulkInput!" was not provided`).
401Unauthenticated, missing or invalid API key.
Menghasilkan URL OAuth berumur pendek yang dikunjungi pengguna untuk memberikan izin kepada Listings API agar dapat mengelola lokasi Google Business Profile mereka secara massal. Arahkan pengguna ke url yang dikembalikan; mereka menyelesaikan proses di layar persetujuan Google dan diarahkan kembali ke salah satu URL yang Anda berikan. Tautan ini berlaku selama 24 jam.
Struktur permintaan. Isi permintaan harus dibungkus dalam objek input yang berisi dua field wajib, successUrl dan errorUrl. Keduanya adalah URL https absolut tempat pengguna diarahkan kembali setelah menyelesaikan (atau membatalkan) proses di layar persetujuan Google; berikan endpoint di aplikasi Anda sendiri yang melanjutkan proses orientasi jika berhasil dan menawarkan percobaan ulang jika terjadi kesalahan. Tidak ada field accountId, tautan penghubung selalu terbatas pada akun pemilik kunci API, dan pengiriman accountId (atau isi permintaan datar tanpa pembungkus) ditolak dengan status HTTP 400.
Ini adalah langkah pertama dalam alur kerja penghubungan massal. Setelah diotorisasi, akun tersebut muncul dalam endpoint daftar akun terhubung (GET /connected-accounts) dengan connectedAccountId yang Anda gunakan untuk setiap panggilan berikutnya.
Contoh penggunaan: orientasi profil Google milik klien agensi. Klien baru menyerahkan akses Google Business Profile mereka. Panggil endpoint ini, arahkan mereka ke url yang dikembalikan, dan setelah mereka memberikan persetujuan, profil bisnis Google mereka tersedia di bawah akun terhubung yang baru. Kemudian jalankan POST /connected-accounts/trigger-matches untuk mencocokkan profil bisnis Google tersebut dengan lokasi Listings API Anda, tinjau pasangan yang dihasilkan dengan GET /connected-accounts/{connectedAccountId}/connection-suggestions, dan finalisasi pasangan tersebut dengan POST /connected-accounts/confirm-matches.
Contoh penggunaan: memperbaiki kredensial yang kedaluwarsa. Ketika token Google milik akun terhubung kedaluwarsa, pembaruan profil bisnis berhenti disinkronkan. Terbitkan ulang tautan penghubung melalui endpoint ini dan minta pemilik akun memberikan otorisasi ulang; koneksi yang ada diperbarui, bukan diduplikasi.
Untuk Facebook, gunakan endpoint connect-facebook. success: true dengan url yang bukan null berarti tautan berhasil dihasilkan; errors hanya diisi ketika pembuatan tautan gagal.
curl -X POST 'https://listingsapi.com/api/v4/connected-accounts/connect-google' \ -H "Authorization: API $LISTINGSAPI_KEY" \ -H 'Content-Type: application/json' \ -d '{ "input": { "successUrl": "https://listingsapi.com/docs/api/connected-accounts-trigger-matches", "errorUrl": "https://listingsapi.com/docs/api/connected-accounts-connect" } }'