Przegląd

Segmenty danych możesz tworzyć i nimi zarządzać za pomocą interfejsu Curation Partners API, który udostępnia curators.dataSegments zasób. 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 Curation Partners API.

  1. Jeśli jeszcze tego nie zrobiono, utwórz projekt Google Cloud Project 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 w konsoli Google Cloud. Wybierz projekt utworzony wcześniej.

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

    1. W polu wyszukiwania wyszukaj Curation Partners API.
    2. Na stronie wyników kliknij Curation Partners API.
    3. Kliknij Włącz.

    Znany jest problem, który może uniemożliwiać znalezienie interfejsu Curation Partners API za pomocą pola wyszukiwania w konsoli Google Cloud. Możesz zamiast tego użyć Google Cloud CLI, aby włączyć interfejs API. Po zainstalowaniu gcloud CLI możesz włączyć interfejs Curation Partners API za pomocą tego polecenia:

    gcloud services enable curationpartners.googleapis.com --project=CLOUD_PROJECT_ID

  4. W menu nawigacyjnym kliknij Dane logowania.

  5. Kliknij + Utwórz dane logowania, a następnie w menu wybierz Konto usługi.

  6. Wpisz nazwę konta usługi. Identyfikator konta usługi zostanie utworzony automatycznie. Zanotuj tę wartość, ponieważ będzie potrzebna w kroku 14. Opcjonalnie możesz wpisać 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 jest widoczne w sekcji Konta usługi. Znajdź i kliknij utworzony identyfikator konta usługi.

  10. Kliknij kartę Klucze.

  11. W menu Dodaj klucz kliknij 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 wywoływania interfejsu API.

  14. Udostępnij identyfikator konta usługi menedżerowi konta technicznego, aby połączyć konto usługi z Twoim kontem.

Zakresy interfejsu API

Podczas wykonywania przepływu 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 Curation Partners API ten zakres to https://www.googleapis.com/auth/curation-partners.

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

W interfejsie Curation Partners API segmenty danych są identyfikowane za pomocą nazwy zasobu specyficznej dla interfejsu API, takiej jak:

"curators/ACCOUNT_ID/dataSegments/DATA_SEGMENT_ID".

Podczas identyfikowania segmentów danych istotnych dla możliwości reklamowej w wyborze w czasie rzeczywistym określ wartość identyfikatora zasobu DATA_SEGMENT_ID, a nie pełną nazwę zasobu podaną przez interfejs API w polu name.

Następne kroki