Leggere l'account connesso
Recupera lo stesso record dell'account che legge il caricamento di una pagina della dashboard, con una sola chiamata e senza campi.
get_account_info è la stessa chiamata che la dashboard fa a ogni caricamento di pagina: nessun
parametro oltre alla tua credenziale, un solo record di account in risposta, che copre piano,
utilizzo, archiviazione e stato della fatturazione in un unico passaggio. Usala ogni volta che il
tuo backend deve sapere con chi sta parlando, o a quale piano e quota si trova in questo momento
quell'account.
Metodo
Get Account Info
Returns the account data for the requesting user, optionally enforcing usage limits.
Procedura
Chiamala con la sola chiave
get_account_info non dichiara campi propri. L'account a cui risponde è quello che la tua
credenziale autentica: una chiave API dell'account o del progetto nel corpo, oppure l'header
xu-gtp-token di un visitatore connesso se la chiami da una sessione del browser.
La risposta
data è il documento dell'account, ridotto a ciò che un client dovrebbe leggere. I campi qui sotto
sono le chiavi reali con cui get_account_data costruisce la risposta, non un esempio di una
struttura più grande e sconosciuta:
account_infoè il profilo: l'email è il campo su cui baserai la maggior parte delle integrazioni.is_boardedè un booleano esplicito (mai mancante), lo stesso flag che la dashboard legge per decidere se mostrare l'onboarding.drive_usage.quota_bytes/quota_unlimitedè lo stesso tetto da cui la barra dell'archiviazione ricava il proprio disegno;quota_unlimited: truesignifica che non devi dare alcun significato aquota_bytesper quell'account.billing_statusporta ogni flag di blocco, sospensione e chiusura in un unico oggetto. Tutto ciò che contiene ènull(o0) su un account in regola, quindi un valore vero in qualsiasi punto è tutto il segnale che ti serve per fermarti e mostrare un messaggio di fatturazione invece di procedere.
Errori
Vedi Errori per i codici condivisi da ogni metodo.