Przewodnik po integracji

Uzyskiwanie klucza prywatnego

Korzystanie z interfejsu wprowadzającego

Aby przeprowadzić integrację z interfejsem API, musisz utworzyć projekt Google Cloud. Gdy to zrobisz, utwórz konto usługi i uzyskasz klucz prywatny. Aby rozpocząć, kliknij ten przycisk:

Utwórz konto usługi

Ręczne generowanie klucza

Jeśli interfejs nie działa, spróbuj wykonać te czynności:

1. Otwórz Google Cloud Console.
2. Wybierz projekt, za pomocą którego będzie można uzyskać dostęp do interfejsu API.
3. W menu administratora „Uprawnienia” znajdź po lewej stronie konta usługi i utwórz nowe konto usługi, które będzie właścicielem projektu.
4. Po utworzeniu konta usługi powinien pojawić się klucz prywatny.

Dodaj konto usługi do białej listy

Gdy utworzysz konto usługi:

1. Skontaktuj się z zespołem GTAF pod adresem [e-mail] za pomocą konta Google, które jest właścicielem projektu. Umieścimy na liście kont Google dostęp do punktów końcowych interfejsu API mobilnej transmisji danych.
2. Powiąż konto usługi z operatorem w Google ISP Portal. Operator może utworzyć to powiązanie, otwierając Dostęp do interfejsu API.

Włącz bibliotekę

Po zakończeniu dodawania białej listy:

1. Otwórz Google Cloud Console.
2. Upewnij się, że w menu u góry menu masz wybrany właściwy projekt.
3. Włącz interfejs API mobilnej transmisji danych w bibliotece interfejsu API.
4. Włącz Preprod Mobile Data Plan API API w bibliotece interfejsu API.

Testowanie dostępu do interfejsu API

Aby przetestować dostęp do metod pomocniczych Google:

1. Zainstaluj oauth2l.

2. Uzyskaj token dostępu do swojego konta usługi w następujący sposób. your-service-account-key-file.json to plik klucza Twojego 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 uruchomisz nowy token dostępu powyżej, uruchom oauth2l reset, aby wyczyścić lokalną pamięć podręczną.

3. Wykonaj poniższe połączenia testowe. YOUR-ASN musi być jednym z numerów ASN, które wysyłasz do nas podczas konfigurowania GTAF podczas procesu integracji. ACCESS-TOKEN-OBTAINED to dane wyjściowe powyżej 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 automatyzacji

Postępuj zgodnie z instrukcjami, aby wykonywać autoryzowane metody po stronie Google z użyciem tego zakresu OAuth:

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

Udostępnianie własności projektu

Wstępna konfiguracja obejmuje tylko 1 konto Google, ale warto, aby grupa autoryzowanych użytkowników miała prawa własności do projektu. W konsoli Google Cloud w menu uprawnień i administratora możesz dodać nowych użytkowników (w tym konta Grup dyskusyjnych Google) jako właścicieli projektu.