Listar las carpetas de GMB de una cuenta conectada

Devuelve las carpetas (también llamadas grupos o grupos de cuentas) de Google Business Profile a las que puede acceder la cuenta de Google conectada. Las carpetas son la forma en que GBP organiza las fichas de negocios dentro de una cuenta; cada una contiene un folderId, un folderName y, cuando Google lo proporciona, un locationCount.

Caso de uso: colocar una ficha nueva en la carpeta correcta. Antes de llamar al endpoint create-GMB-listing, enumera las carpetas de la cuenta y deja que el cliente elija una. Pasa el folderId elegido (la cadena accounts/{id}, sin modificar) para que la ficha nueva se cree dentro de esa carpeta en lugar de en la raíz de la cuenta.

Caso de uso: conciliar con la estructura de GBP de un cliente. Las marcas con varias ubicaciones suelen distribuir sus fichas entre distintas carpetas. Obtén la lista de carpetas para mostrar la jerarquía real de GBP del cliente en tu interfaz de usuario y confirmar que estás sincronizando las fichas con la carpeta que espera. Ten en cuenta que locationCount puede ser null cuando Google no devuelve un recuento para la carpeta, así que trátalo como un dato opcional y no como una fuente definitiva. Este endpoint requiere una cuenta conectada de tipo Google; la ruta solo es válida para conexiones GoogleAccount.