Przegląd

Segmenty danych możesz tworzyć i nimi zarządzać za pomocą interfejsu Authorized Buyers Marketplace API, który udostępnia zasób curators.dataSegments. Jest to interfejs API REST z wygenerowanymi bibliotekami klienta, których możesz używać w integracji.

Konfigurowanie uwierzytelniania

Interfejsy API Google używają protokołu OAuth 2.0 do uwierzytelniania i autoryzacji. Oto jak skonfigurować konto usługi, aby uzyskać dostęp do interfejsu Marketplace API.

  1. Jeśli jeszcze tego nie zrobiono, utwórz projekt Google Cloud, w którym będą przechowywane dane logowania używane do uzyskiwania dostępu do interfejsu API.

  2. Otwórz stronę Włączone interfejsy API Google Cloud Console. Wybierz utworzony wcześniej projekt.

  3. Zobaczysz listę włączonych interfejsów API i usług. Aby uzyskać dostęp do interfejsu Marketplace API, musisz go włączyć. Jeśli interfejs Marketplace API nie jest włączony, kliknij + Włącz interfejsy API i usługi i wykonaj te instrukcje:

    1. Przekierujemy Cię na stronę z polem wyszukiwania. Wyszukaj Authorized Buyers Marketplace API.
    2. Na stronie wyników wybierz Authorized Buyers Marketplace API.
    3. Kliknij Włącz.

  4. W menu nawigacyjnym kliknij Dane logowania.

  5. Kliknij +Utwórz dane logowania, a w wyświetlonym menu wybierz Konto usługi.

  6. Wpisz nazwę konta usługi. Identyfikator konta usługi jest tworzony automatycznie podczas tworzenia konta. Zanotuj tę wartość, ponieważ będzie potrzebna w kroku 14. Opcjonalnie wpisz opis. Kliknij Utwórz i kontynuuj.

  7. Opcjonalnie skonfiguruj uprawnienia konta usługi i kliknij Dalej.

  8. Opcjonalnie skonfiguruj użytkowników lub grupy, które mogą wykonywać działania jako konto usługi, i kliknij Gotowe.

  9. Nowe konto usługi pojawi się na liście Konta usługi. Znajdź i kliknij utworzony identyfikator konta usługi.

  10. Kliknij kartę Klucze.

  11. W menu Dodaj klucz wybierz Utwórz nowy klucz.

  12. W polu Typ klucza wybierz JSON i kliknij Utwórz.

  13. Pobierz klucz do katalogu roboczego. Więcej informacji o bezpiecznym przechowywaniu klucza znajdziesz w artykule Zarządzanie kluczami konta usługi. Klucz jest używany przez aplikację do wykonywania wywołań interfejsu API.

  14. Prześlij identyfikator konta usługi do swojego technicznego menedżera konta, aby połączyć konto usługi z Twoim kontem.

Zakresy interfejsu API

Podczas przechodzenia przez proces OAuth 2.0 w celu uzyskania tokena dostępu używanego do wywoływania interfejsu API musisz określić interfejsy API, do których można uzyskać dostęp za pomocą tego tokena. W przypadku interfejsu Authorized Buyers Marketplace API ten zakres to https://www.googleapis.com/auth/authorized-buyers-marketplace.

Jak identyfikować segmenty danych w interfejsie API w porównaniu z selekcją w czasie rzeczywistym

W interfejsie Marketplace API segmenty danych są identyfikowane za pomocą zasobu name specyficznego dla interfejsu API, np.:

"curators/[YOUR_ACCOUNT_ID]/dataSegments/[DATA_SEGMENT_ID]".

Podczas identyfikowania segmentów danych istotnych dla możliwości wyświetlenia reklamy w ramach selekcjonowania w czasie rzeczywistym podaj wartość identyfikatora zasobu DATA_SEGMENT_ID zamiast pełnego zasobu name używanego przez interfejs API.

Następne kroki