Leer la cuenta con sesión iniciada
Obtén el mismo registro de cuenta que lee la carga de una página del dashboard, con una sola llamada y sin campos.
get_account_info es la misma llamada que hace el dashboard en cada carga de página: sin más parámetros que tu credencial, devuelve un registro de cuenta que cubre plan, uso, almacenamiento y estado de facturación en un solo viaje. Úsala siempre que tu propio backend necesite saber con quién habla, o en qué plan y cuota está esa cuenta ahora mismo.
Método
Get Account Info
Returns the account data for the requesting user, optionally enforcing usage limits.
Paso a paso
Llámala solo con tu clave
get_account_info no declara campos propios. La cuenta a la que responde es la que autentica tu credencial: una clave de API de cuenta o de proyecto en el cuerpo, o la cabecera xu-gtp-token de un visitante con sesión iniciada si llamas desde una sesión de navegador.
La respuesta
data es el documento de la cuenta, recortado a lo que debe leer un cliente. Los campos de abajo son las claves reales con las que get_account_data construye la respuesta, no una muestra de una estructura mayor desconocida:
account_infoes el perfil: el correo es el campo en el que basarás la mayoría de las integraciones.is_boardedes un booleano explícito (nunca falta), el mismo indicador que lee el dashboard para decidir si muestra la incorporación inicial.drive_usage.quota_bytes/quota_unlimitedes el mismo tope con el que se dibuja la barra de almacenamiento;quota_unlimited: truesignifica que no debes dar ningún sentido aquota_bytespara esa cuenta.billing_statuslleva todos los indicadores de bloqueo, suspensión y cancelación en un solo objeto. Todo lo que contiene esnull(o0) en una cuenta sana, así que un valor verdadero en cualquier parte de él es toda la señal que necesitas para detenerte y mostrar un mensaje de facturación en lugar de continuar.
Errores
Consulta Errores para ver los códigos que comparten todos los métodos.