Guida all'integrazione

Ottenere la chiave privata

Utilizzo dell'interfaccia di onboarding

Per l'integrazione con l'API, devi creare un progetto Google Cloud. Dopodiché, crea un service account e ottieni una chiave privata. Per iniziare, fai clic sul seguente pulsante:

Crea service account

Generazione manuale della chiave

Se l'interfaccia precedente non funziona, prova a procedere nel seguente modo:

  1. Vai alla console Google Cloud.
  2. Scegli il progetto utilizzando il quale verrà eseguito l'accesso all'API.
  3. Nel menu IAM e amministrazione a sinistra, trova gli account di servizio e crea un nuovo service account che sarà il proprietario del progetto.
  4. Una volta creato il service account, dovresti ricevere una chiave privata.

Service account nella lista consentita

Dopo aver creato un service account:

  1. Contatta il team GTAF all'indirizzo mdp-support@google.com con un Account Google che sia il proprietario del progetto. Inseriremo l'account Google nella lista consentita per accedere agli endpoint dell'API Mobile Data Plan Sharing.
  2. Associa l'account di servizio all'operatore sul portale Google ISP. L'operatore può effettuare questa associazione andando ad Accesso API.

Abilitare la raccolta

Una volta completata la creazione della lista consentita:

  1. Visita la console Google Cloud.
  2. Assicurati di aver selezionato il progetto corretto nel menu a discesa della barra dei menu in alto.
  3. Attiva l'API Mobile Data Plan Sharing nella libreria API.
  4. Abilita l'API Mobile Data Plan Sharing di preproduzione nella libreria API.

Testare l'accesso all'API

Per testare l'accesso ai metodi lato Google:

  1. Installa oauth2l.

  2. Ottieni un token di accesso per il service account nel seguente modo. your-service-account-key-file.json è un file di chiavi del service account.

    > oauth2l fetch --json your-service-account-key-file.json dataplansharing

    Tieni presente che il token di accesso scade dopo circa un'ora. Prima di eseguire di nuovo il comando precedente per un nuovo token di accesso, esegui oauth2l reset per cancellare la cache locale.

  3. Esegui chiamate di prova nel seguente modo. YOUR-ASN deve essere uno degli ASN che ci invii quando abbiamo configurato GTAF durante la procedura di integrazione. ACCESS-TOKEN-OBTAINED è l'output del comando oauth2l fetch riportato sopra. PLAN_STATUS è il PlanStatus corpo della richiesta che vuoi inviare a GTAF.

    > url_domain="mobiledataplansharing.googleapis.com"
> url_path="v1/operators/YOUR-ASN/clients/mobiledataplan/users/USER_KEY/planStatus"
> curl -H "Content-Type: application/json" \
       -d 'PLAN_STATUS' \
       -X POST "https://$url_domain/$url_path?access_token=ACCESS-TOKEN-OBTAINED"

Chiamate API programmatiche

Segui le istruzioni per effettuare chiamate autorizzate ai metodi lato Google, con il seguente ambito OAuth:

https://www.googleapis.com/auth/dataplansharing

Condividere la proprietà del progetto

Sebbene la configurazione iniziale preveda un singolo Account Google, è consigliabile che un gruppo di utenti autorizzati sia proprietario del progetto. Nella console Google Cloud, nel menu IAM e amministrazione, puoi aggiungere nuovi membri (incluso l'account dei gruppi Google) come proprietari del progetto.