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 le condizioni della piattaforma Channel Services.

Accedere alla Partner Sales Console almeno una volta in qualità di 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 della Partner Sales Console.

Nota: è necessario il tuo ID account, che si trova nelle impostazioni di Partner Sales Console pagina per l'integrazione dell'API.

Passaggio 2: configura il progetto Google Cloud

Per utilizzare qualsiasi API Google, devi disporre di 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 delle migliori consulta la nostra guida Creare e gestire progetti.

La maggior parte dei rivenditori crea progetti Google Cloud all'interno del proprio all'organizzazione Google Cloud anziché nel dominio del rivenditore. Accesso del dominio rivenditore vengono concessi configurando delega a livello di dominio per consentire a un account di servizio di accedere provenienti dal 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 account di servizio

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

Vai ad Account di servizio

Nota: Se non vengono gestite correttamente, le chiavi degli account di servizio comportano un rischio per la sicurezza. Dovresti Scegliere un'alternativa più sicura alle chiavi degli account di servizio ove 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 è possibile creare una chiave dell'account di servizio, è possibile disattivato per la tua organizzazione. Per ulteriori informazioni, consulta 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, facoltativo, l'Account di servizio) descrizione), quindi fai clic su Crea.
3. Fai clic su Continua per saltare il passaggio 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 del 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 di autenticarsi con il proprio account di servizio. Puoi spostare e rinominare questo file come desideri.

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. Da Nel menu Azioni, seleziona Gestisci i dettagli e copia il tuo ID univoco.

Vai alla sezione Pagina di delega a livello di dominio utilizzando l'account di super amministratore del 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 aver 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: potresti dover abilitare 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 consulta 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 dominio del rivenditore di prova. Assicurati di creare un progetto separato Le API di Google hanno quote per progetto. Condivisione di un progetto in più ambienti i tuoi account di test potrebbero influire sulle quote dell'account di produzione.