/api/v4/connected-accounts/{connectedAccountId}/foldersCantumkan folder GMB untuk akun yang terhubung
Mengembalikan folder (grup) Google Business Profile yang dapat diakses oleh akun Google yang terhubung.
Parameter
Path
| Nama | Tipe | Wajib | Deskripsi |
|---|---|---|---|
| connectedAccountId | string | wajib | UUID of the connected Google account (from the list connected accounts endpoint). |
Respons
200Array of GMB folder objects.
{ "data": { "getFoldersUnderGoogleAccount": [ { "folderId": "accounts/104890024806530350198", "folderName": "Aniruddha Basu", "locationCount": null } ] }}401Unauthenticated, missing or invalid API key.
429Rate limit exceeded. Retry after the `Retry-After` header value.
Mengembalikan folder (juga disebut grup atau grup akun) di Google Business Profile yang dapat diakses oleh akun Google yang terhubung. GBP menggunakan folder untuk menata profil bisnis dalam sebuah akun; setiap folder memiliki folderId, folderName, dan, jika dilaporkan oleh Google, locationCount.
Contoh penggunaan: tempatkan profil bisnis baru di folder yang tepat. Sebelum memanggil endpoint create-GMB-listing, cantumkan folder akun tersebut dan biarkan pelanggan memilih salah satunya. Teruskan folderId yang dipilih (string accounts/{id}, yang digunakan tanpa perubahan) agar profil bisnis baru dibuat di dalam folder tersebut, bukan di tingkat akar akun.
Contoh penggunaan: cocokkan dengan struktur GBP pelanggan. Merek dengan banyak lokasi sering membagi profil bisnis ke beberapa folder. Ambil daftar folder untuk menampilkan hierarki GBP pelanggan yang sebenarnya di antarmuka pengguna Anda dan memastikan bahwa Anda menyinkronkan ke folder yang mereka harapkan. Perhatikan bahwa locationCount dapat bernilai null jika Google tidak mengembalikan jumlah untuk folder tersebut, jadi perlakukan nilai ini sebagai informasi opsional, bukan acuan pasti. Endpoint ini memerlukan akun terhubung bertipe Google; path ini hanya valid untuk koneksi GoogleAccount.
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/folders' \ -H "Authorization: API $LISTINGSAPI_KEY"