Ecco come utilizzare l'API CSS:
Autorizzazioni
Per utilizzare l'API CSS, devi configurare le autorizzazioni in due posizioni: Google Cloud e CSS Center.
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.
CSS Center:
- L'indirizzo email del service account (ad es.
your-service-account-name@your-project-id.iam.gserviceaccount.com
) 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.
- L'indirizzo email del service account (ad es.
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 |
---|---|
|
|
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.