Przewodnik integracji

Uzyskiwanie klucza prywatnego

Korzystanie z interfejsu rejestrowania

Aby zintegrować się z interfejsem API, musisz utworzyć projekt Google Cloud. Następnie utwórz konto usługi i uzyskaj klucz prywatny. Aby rozpocząć, kliknij przycisk poniżej:

Utwórz konto usługi

Ręczne generowanie klucza

Jeśli powyższy interfejs nie działa, wykonaj te czynności:

  1. Otwórz konsolę Google Cloud.
  2. Wybierz projekt, za pomocą którego będzie uzyskiwany dostęp do interfejsu API.
  3. W menu Administracja po lewej stronie znajdź konta usługi i utwórz nowe konto usługi, które będzie właścicielem projektu.
  4. Po utworzeniu konta usługi otrzymasz klucz prywatny.

Umieszczanie konta usługi na białej liście

Po utworzeniu konta usługi:

  1. Skontaktuj się z zespołem GTAF pod adresem mdp-support@google.com, podając konto Google, które jest właścicielem projektu. Umieścimy konto Google na białej liście, aby umożliwić mu dostęp do punktów końcowych interfejsu Mobile Data Plan Sharing API.
  2. Powiąż konto usługi z operatorem w portalu Google ISP. Operator może utworzyć to powiązanie, klikając Dostęp do interfejsu API.

Włącz bibliotekę

Po dodaniu do białej listy:

  1. Otwórz konsolę Google Cloud.
  2. Sprawdź, czy w menu na górnym pasku wybrano odpowiedni projekt.
  3. Włącz interfejs API udostępniania mobilnej transmisji danych w Bibliotece interfejsów API.
  4. Włącz interfejs API udostępniania mobilnej transmisji danych w środowisku przedprodukcyjnym w bibliotece interfejsów API.

Testowanie dostępu do interfejsu API

Aby przetestować dostęp do metod po stronie Google:

  1. Zainstaluj oauth2l.

  2. Uzyskaj token dostępu dla konta usługi w ten sposób: your-service-account-key-file.json to plik klucza konta usługi.

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

    Pamiętaj, że token dostępu wygasa po około godzinie. Zanim ponownie uruchomisz powyższe polecenie, aby uzyskać nowy token dostępu, uruchom polecenie oauth2l reset, aby wyczyścić lokalną pamięć podręczną.

  3. Wydawaj testowe połączenia w ten sposób: YOUR-ASN musi być jednym z numerów ASN, które przesyłasz do nas podczas konfigurowania GTAF w ramach procesu integracji. ACCESS-TOKEN-OBTAINED to wynik powyższego polecenia oauth2l fetch. PLAN_STATUS to treść żądania PlanStatus, którą chcesz wysłać do 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"

Wywołania interfejsu API w ramach automatyzacji

Postępuj zgodnie z instrukcjami, aby wykonywać autoryzowane wywołania metod po stronie Google z tym zakresem OAuth:

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

Udostępnianie własności projektu

Początkowa konfiguracja obejmuje jedno konto Google, ale warto, aby projekt był własnością grupy autoryzowanych użytkowników. W konsoli Google Cloud w menu Administracja możesz dodać nowych członków (w tym konto grupy Google), którzy będą właścicielami projektu.