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łączonych interfejsów API w 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 zostanie utworzony automatycznie podczas tworzenia konta. Zanotuj tę wartość, ponieważ będzie potrzebna później 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 przed chwilą 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. Podaj identyfikator konta usługi menedżerowi ds. technicznych, 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 zakres ten 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ą nazwy zasobu specyficznej dla interfejsu API, np.:

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

Podczas określania segmentów danych istotnych w przypadku możliwości wyświetlenia reklamy w ramach selektywnego doboru w czasie rzeczywistym podaj wartość DATA_SEGMENT_ID identyfikatora zasobu zamiast pełnego zasobuname używanego przez interfejs API.

Następne kroki