Configurazione tecnica

Prima di iniziare

Prima di iniziare, devi disporre di quanto segue:

• Accesso come super amministratore al dominio del rivenditore. Per saperne di più, scopri come accedere all'API Cloud Channel.

• Accesso alla console Google Cloud e alla Partner Sales Console.

Passaggio 1: prepara la Partner Sales Console

Prima di poter utilizzare l'API, devi accettare i termini e le condizioni della piattaforma Channel Services.

Accedi alla Partner Sales Console almeno una volta come amministratore del dominio del rivenditore. La prima volta che accedi, devi accettare i Termini di servizio del rivenditore, se applicabili. Se hai accettato termini di servizio specifici offline, questo passaggio non è applicabile al tuo caso.

Puoi accettare termini di servizio aggiuntivi nella pagina Termini della Partner Sales Console.

Nota: per l'integrazione dell'API, devi disporre del tuo ID account, disponibile nella pagina Impostazioni di Partner Sales Console.

Passaggio 2: configura il progetto Google Cloud

Per utilizzare qualsiasi API Google, devi avere un progetto Google Cloud.

Crea un progetto Google Cloud

Per creare un progetto, vai all'area Progetti della console Google Cloud e fai clic su Crea progetto.

Per istruzioni più dettagliate sulla creazione di un progetto e per un elenco di best practice, consulta la nostra guida Creare e gestire progetti.

La maggior parte dei rivenditori crea progetti Google Cloud nella propria organizzazione Google Cloud principale anziché nel dominio del rivenditore. L'accesso ai dati del dominio del rivenditore viene concesso configurando la delega a livello di dominio per consentire a un account di servizio di accedere ai dati del dominio del rivenditore.

Assegna al progetto un nome descrittivo. L'ID progetto è un identificatore arbitrario che non influisce sulla tua capacità di chiamare l'API Cloud Channel.

Abilita l'API

Vai alla sezione Libreria API nella console Google Cloud e attiva l'API Cloud Channel.

Crea un account di servizio

Per creare l'account di servizio, vai alla pagina Account di servizio.

Vai ad Account di servizio

Nota: le chiavi degli account di servizio comportano un rischio per la sicurezza se non vengono gestite correttamente. Dovresti scegliere un'alternativa più sicura alle chiavi degli account di servizio quando è possibile. Se devi effettuare l'autenticazione con una chiave dell'account di servizio, sei responsabile della sicurezza della chiave privata e di altre operazioni descritte dalle best practice per la gestione delle chiavi degli account di servizio. Se non riesci a creare una chiave del account di servizio, la creazione di chiavi del account di servizio potrebbe essere disabilitata per la tua organizzazione. Per ulteriori informazioni, vedi Gestione delle risorse dell'organizzazione sicure per impostazione predefinita.

1. Fai clic su Crea account di servizio.
2. Inserisci il nome account di servizio (e facoltativamente la descrizione account di servizio) e fai clic su Crea.
3. Fai clic su Continua per saltare l'opzione Concedi all'account di servizio l'accesso al progetto.
4. Salta la sezione Concedi agli utenti l'accesso a questo account di servizio e fai clic su Fine per completare la creazione dell'account.

Dopo aver creato l'account, crea una chiave dell'account di servizio:

1. Nella console Google Cloud, fai clic sull'indirizzo email dell'account di servizio che hai creato.
2. Fai clic su Chiavi.
3. Fai clic su Aggiungi chiave, quindi su Crea nuova chiave.

4. Fai clic su Crea. Un file della chiave JSON viene scaricato sul computer.

   Assicurati di archiviare il file della chiave in modo sicuro perché può essere utilizzato per l'autenticazione come account di servizio. Puoi spostare e rinominare il file come preferisci.

5. Fai clic su Chiudi.

Puoi eliminare e creare file della chiave privata dalla pagina Account di servizio.

Passaggio 3: autorizza l'account di servizio per il dominio del rivenditore

Per questa sezione ti serve l'ID client del tuo account di servizio. Nel menu Azioni, seleziona Gestisci dettagli e copia il tuo ID univoco.

Vai alla pagina Delega a livello di dominio utilizzando l'account super amministratore del dominio del rivenditore.

• Fai clic su Aggiungi nuovo e inserisci l'ID del tuo account di servizio nel campo ID client.
• Inserisci https://www.googleapis.com/auth/apps.order nel campo Ambiti OAuth.
• Fai clic su Autorizza per consentire al tuo account di servizio di utilizzare l'API Cloud Channel nel contesto del tuo account Channel Services.

Nota: se utilizzi API aggiuntive nell'integrazione finale, potresti avere più di un ambito per il client del tuo account di servizio.

Poi fai clic su Autorizza in modo che il tuo account di servizio possa utilizzare l'API Cloud Channel nel contesto del tuo account Channel Services.

Nota: potrebbe essere necessario attivare altre API e aggiungere altri ambiti in altri codelab. L'integrazione finale potrebbe avere più di un ambito per il client dell'account di servizio.

Passaggi successivi

Ora che hai un'integrazione tecnica iniziale, puoi scoprire l'API leggendo la documentazione dell'API Cloud Channel.

Nota: se hai anche una Console Partner Sales di prova, segui i passaggi da 1 a 4 con il tuo dominio rivenditore di prova. Assicurati di creare un progetto separato poiché le API di Google hanno quote per progetto. La condivisione di un progetto tra ambienti potrebbe causare un impatto degli account di test sulle quote dell'account di produzione.