Configurazione tecnica

Prima di iniziare

Prima di iniziare, è necessario quanto segue:

• Accesso come super amministratore al tuo dominio rivenditore. Per ulteriori informazioni, 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 condizioni della piattaforma Channel Services.

Accedi almeno una volta alla Partner Sales Console come amministratore del dominio del rivenditore. La prima volta che accedi, devi accettare i Termini di servizio per i rivenditori, 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 di Partner Sales Console.

Nota: per l'integrazione dell'API è necessario il tuo ID account, che trovi nella pagina Impostazioni di Partner Sales Console.

Passaggio 2: configura il progetto Google Cloud

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

Creare 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 Creazione e gestione dei 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 dal dominio del rivenditore viene concesso impostando 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 abilita l'API Cloud Channel.

Crea un service account

Per creare il tuo account di servizio, vai alla pagina Account di servizio.

Vai ad Account di servizio

Nota: Le chiavi dell'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 eseguire l'autenticazione con una chiave dell'account di servizio, sei responsabile della sicurezza della chiave privata e delle altre operazioni descritte nelle Best practice per la gestione delle chiavi degli account di servizio. Se non ti è consentito creare una chiave dell'account di servizio, la creazione delle chiavi dell'account di servizio potrebbe essere disabilitata per la tua organizzazione. Per maggiori informazioni, consulta Gestire le risorse dell'organizzazione sicure per impostazione predefinita.

1. Fai clic su Crea account di servizio.
2. Inserisci il Nome account di servizio (e la descrizione account di servizio facoltativa), quindi 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. Sul computer viene scaricato un file della chiave JSON.

   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 questo file come preferisci.

5. Fai clic su Chiudi.

Puoi eliminare e creare file di chiavi private dalla pagina Account di servizio.

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

Per questa sezione è necessario l'ID client dell'account di servizio. Nel menu Azioni, seleziona Gestisci dettagli e copia il tuo ID univoco.

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

• Fai clic su Aggiungi nuovo e inserisci l'ID dell'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.

Fai quindi clic su Autorizza per consentire al tuo account di servizio di utilizzare l'API Cloud Channel nel contesto del tuo account Channel Services.

Nota: potresti dover abilitare altre API e aggiungere altri ambiti in altri codelab. L'integrazione finale potrebbe avere più di un ambito per il client del tuo account di servizio.

Passaggi successivi

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

Nota: se disponi anche di una Test Partner Sales Console, segui i passaggi da uno a quattro con il tuo dominio di rivenditore di prova. Assicurati di creare un progetto separato poiché le API di Google hanno quote per progetto. La condivisione di un progetto in più ambienti potrebbe causare l'impatto dei tuoi account di test sulle quote dell'account di produzione.