Servizi Google avanzati

I servizi avanzati di Apps Script permettono agli sviluppatori esperti di connettersi alcune API pubbliche di Google con meno configurazioni rispetto alle interfacce HTTP. I servizi avanzati sono essenzialmente wrapper sottile attorno alle API di Google. Loro funzionano in modo molto simile a servizi integrati, ad esempio offrendo e Apps Script gestisce il completamento automatico flusso di autorizzazione automatica. Tuttavia, devi attivare un servizio avanzato prima puoi usarlo in uno script.

Per vedere quali API di Google sono disponibili come servizi avanzati, cerca il parametro nella sezione Servizi Google avanzati della Riferimento. Se vuoi utilizzare un'API di Google che non è disponibile come servizio avanzato, puoi connetterti al servizio come a qualsiasi altro API esterna.

Servizi avanzati o HTTP?

Ciascuno dei servizi avanzati di Google è associato a un'API di Google pubblica. In Apps Script, puoi accedere a queste API tramite servizi avanzati o semplicemente le richieste API direttamente UrlFetch

Se utilizzi il metodo di servizio avanzato, Apps Script gestisce i flusso di autorizzazione e offerte il supporto del completamento automatico. Tuttavia, devi attiva il servizio avanzato per poterlo utilizzare li annotino. Inoltre, alcuni servizi avanzati forniscono solo un sottoinsieme dei di archiviazione disponibili nell'API.

Se utilizzi il metodo UrlFetch per accedere direttamente all'API, trattando essenzialmente l'API di Google come un API esterna. Con questo metodo, diversi aspetti dell'API. Tuttavia, richiede che tu gestisca l'API l'autorizzazione. Devi inoltre creare le intestazioni e analizzare le risposte dell'API.

In generale, è più semplice utilizzare un servizio avanzato, ove possibile e solo utilizza il metodo UrlFetch quando il servizio avanzato non fornisce il le funzionalità di cui hai bisogno.

Requisiti

Prima di poter utilizzare un servizio avanzato, devi soddisfare i seguenti requisiti requisiti:

  1. Devi attivare il servizio avanzato nel progetto di script.

  2. Devi assicurarti che l'API corrispondente al servizio avanzato sia abilitata nel progetto Cloud Platform (Google Cloud) utilizzate dal tuo script.

    Se il progetto di script utilizza un progetto Google Cloud predefinito create a partire dall'8 aprile 2019, l'API viene abilitata automaticamente dopo aver abilitato il servizio avanzato e salvato il progetto dello script. Se non l'hai ancora fatto, potresti anche ha chiesto di accettare i Termini e condizioni d'uso di Google Cloud e i Termini di servizio delle API di Google.

    Se il progetto di script utilizza un oggetto progetto Google Cloud standard o un progetto Google Cloud predefinito precedente, devi abilitare l'API corrispondente del servizio avanzato nel progetto Google Cloud manualmente. Devi disporre dell'accesso in modifica al progetto Google Cloud per apportare questa modifica.

Consulta i progetti della piattaforma Cloud per ulteriori informazioni.

Abilita i servizi avanzati

Per utilizzare un servizio Google avanzato, segui queste istruzioni:

  1. Apri il progetto Apps Script.
  2. A sinistra, fai clic su Editor .
  3. A sinistra, accanto a Servizi, fai clic su Aggiungi un servizio. .
  4. Seleziona un servizio Google avanzato e fai clic su Aggiungi.

Una volta abilitato, il servizio avanzato è disponibile nel completamento automatico.

Come vengono determinate le firme dei metodi

I servizi avanzati in genere utilizzano gli stessi oggetti, nomi di metodi e parametri come le API pubbliche corrispondenti, sebbene le firme dei metodi siano tradotte in Apps Script. L'editor di script funzione di completamento automatico di solito fornisce informazioni sufficienti per iniziare, ma le regole seguenti spiegano il modo in cui Apps Script genera una firma del metodo da un'API pubblica di Google.

Le richieste alle API di Google possono accettare vari tipi di dati, inclusi i parametri di percorso, i parametri di query, un corpo della richiesta e/o un elemento multimediale carica allegato. Alcuni servizi avanzati possono anche accettare richieste HTTP specifiche (ad esempio, servizio avanzato di Calendar).

La firma del metodo corrispondente in Google Apps Script ha le seguenti caratteristiche: argomenti:

  1. Il corpo della richiesta (di solito una risorsa), come oggetto JavaScript.
  2. Percorso o parametri obbligatori come singoli argomenti.
  3. L'allegato del caricamento di contenuti multimediali, come Blob .
  4. Parametri facoltativi, come nomi dei parametri di mappatura degli oggetti JavaScript a e i relativi valori.
  5. Intestazioni delle richieste HTTP, come un oggetto JavaScript che mappa i nomi delle intestazioni all'intestazione. e i relativi valori.

Se il metodo non ha elementi in una determinata categoria, quella parte del viene omessa.

Ci sono alcune eccezioni speciali di cui tenere conto:

  • Per i metodi che accettano un caricamento di contenuti multimediali, viene impostato il parametro uploadType automaticamente.
  • I metodi denominati delete nell'API di Google sono denominati remove in Apps Script, poiché delete è una parola riservata in JavaScript.
  • Se un servizio avanzato è configurato per accettare le intestazioni delle richieste HTTP e impostare un oggetto JavaScript per le intestazioni della richiesta, devi impostare anche l'oggetto facoltativo parametri (in un oggetto vuoto se non utilizzi parametri facoltativi).

Assistenza per servizi avanzati

I servizi avanzati sono semplicemente wrapper sottili che consentono l'uso di un all'interno di Apps Script. Di conseguenza, qualsiasi problema riscontrato durante il loro utilizzo di solito un problema con l'API sottostante, non con Apps Script stesso.

Se riscontri un problema durante l'utilizzo di un servizio avanzato, dovrebbe essere vengono segnalate utilizzando le istruzioni di assistenza per l'API sottostante. Link a questi le istruzioni per l'assistenza sono disponibili in ogni guida di assistenza avanzata nel Riferimento di Apps Script.