Inizia a utilizzare l'API CSS

Ecco come utilizzare l'API CSS:

Autorizzazioni

Per utilizzare l'API CSS, devi configurare le autorizzazioni in due posizioni: Google Cloud e CSS Center.

1. Google Cloud IAM:

   • Crea un service account nella console Google Cloud. Segui istruzioni simili a quelle per l'API Content per creare e scaricare il file JSON delle credenziali. Questo passaggio autentica il tuo service account come entità Google Cloud valida.
   • Se utilizzi l'accesso REST diretto o le librerie client dell'API di Google, devi anche disporre di una chiave API generata dalla console Google Cloud.

2. CSS Center:

   • L'indirizzo email del service account (ad es. [e-mail]) deve essere aggiunto come utente con accesso amministrativo al tuo account CSS Center. Questo passaggio autorizza il service account ad accedere e gestire i dati di CSS Center.
   • Puoi concedere l'accesso a livello di gruppo di CSS (per l'accesso a tutti i domini) o a specifici account di domini CSS. Per l'accesso all'API, è comune concedere l'accesso a livello di gruppo CSS.
   • Per aggiungere il service account:
     • Accedi a CSS Center con un utente amministratore.
     • Vai ad Accesso all'account (sotto l'icona a forma di ingranaggio ⚙️).
     • Fai clic su + Aggiungi utente e inserisci l'email dell'account di servizio.
     • Imposta il livello di accesso su Amministratore.
   • La propagazione delle autorizzazioni potrebbe richiedere fino a 30 minuti. Se si verificano errori di autorizzazione, riprova più tardi.

Ambito di autenticazione:

L'ambito OAuth 2.0 richiesto per l'API CSS è:

• https://www.googleapis.com/auth/content

Verifica che la tua applicazione richieda questo ambito durante l'autenticazione.

Abilita l'API CSS

Per utilizzare l'API CSS, devi abilitarla nel tuo progetto Google Cloud. Puoi trovare la libreria all'indirizzo https://console.cloud.google.com/apis/library/css.googleapis.com.

Inizia a programmare

L'API CSS include esempi di codice e librerie client per aiutarti a iniziare. Abbiamo anche una pagina con le best practice.

Invio di richieste

Invia richieste agli URL nel seguente formato:

https://css.googleapis.com/{version}/{resource name}:{method}…

dove {resource name} è il nome della risorsa interessata dalla chiamata.

Ad esempio, ecco come eliminare una risorsa con gRPC:

https://css.googleapis.com/v1/{resource name}:delete

Ecco come eliminare una risorsa con REST:

DELETE https://css.googleapis.com/v1/{resource name}

Per ulteriori dettagli su servizi specifici, consulta la documentazione di riferimento dell'API CSS.

Utilizza gRPC o REST

L'API CSS supporta gRPC e REST. Ecco i due modi per effettuare chiamate API CSS:

gRPC (consigliato)	REST
Crea il corpo della richiesta come protocol buffer. Invia il corpo della richiesta al server con HTTP/2. Deserializza la risposta in un protocol buffer. Interpreta i risultati.	Crea il corpo della richiesta come oggetto JSON. Invialo al server utilizzando HTTP 1.1. Deserializza la risposta come oggetto JSON. Interpreta i risultati.

Nota: se utilizzi una libreria client, il meccanismo di trasporto predefinito è gRPC. Nella maggior parte dei casi, per utilizzare gRPC non devi fare altro che chiamare gli endpoint dell'API CSS.

Richiedi assistenza

Contatta il tuo rappresentante di Google per ricevere assistenza o utilizza il modulo di feedback per segnalare eventuali problemi.

Ecco come puoi fornire ulteriori feedback se riscontri problemi:

Invia feedback

Per fornire un feedback, invia uno dei seguenti elementi:

• Funzionalità dell'API:invia il modulo di feedback
• Documentazione:utilizza le valutazioni con i pollici in-page e il pulsante Invia feedback.
• Esempi e librerie:utilizza il pulsante Nuovo problema su GitHub.

Per fornire un feedback generale dopo aver implementato ogni attività, utilizza il modulo di feedback.