GET/api/v4/connected-accounts/{connectedAccountId}/folders

Elenca le cartelle GMB di un account collegato

Restituisce le cartelle (gruppi) di Google Business Profile accessibili a un account Google collegato.

Richiede una chiave API. Consulta Autenticazione per il formato dell’header e la rotazione delle chiavi.

Parametri

Percorso

NomeTipoObbligatorioDescrizione
connectedAccountIdstringobbligatorioUUID of the connected Google account (from the list connected accounts endpoint).

Risposte

200Array of GMB folder objects.
Response
{  "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.

Restituisce le cartelle (chiamate anche gruppi o gruppi di account) di Google Business Profile a cui l'account Google collegato può accedere. GBP usa le cartelle per organizzare le schede delle attività all'interno di un account; ogni cartella contiene un folderId, un folderName e, quando Google lo fornisce, un locationCount.

Caso d'uso: inserire una nuova scheda nella cartella corretta. Prima di chiamare l'endpoint create-GMB-listing, elenca le cartelle dell'account e lascia che il cliente ne scelga una. Passa il folderId scelto (la stringa accounts/{id}, usata senza modifiche) affinché la nuova scheda venga creata all'interno di quella cartella anziché nella radice dell'account.

Caso d'uso: verificare la corrispondenza con la struttura GBP di un cliente. I marchi con più sedi spesso distribuiscono le schede tra più cartelle. Recupera l'elenco delle cartelle per visualizzare la gerarchia GBP effettiva del cliente nella tua interfaccia utente e confermare che la sincronizzazione avvenga nella cartella prevista dal cliente. Tieni presente che locationCount può essere null quando Google non restituisce un conteggio per la cartella, quindi trattalo come un dato facoltativo anziché come un riferimento certo. Questo endpoint richiede un account collegato di tipo Google; il percorso è valido solo per le connessioni GoogleAccount.

Request
curl -X GET 'https://listingsapi.com/api/v4/connected-accounts/<connectedAccountId>/folders' \  -H "Authorization: API $LISTINGSAPI_KEY"