Przesyłanie pliku SDF za pomocą interfejsu Display & Video 360 API – pilot

W ramach programu pilotażowego klienci mogą testować nową funkcję interfejsu Display & Video 360 API w wersji beta, która umożliwia im przesyłanie plików uporządkowanych danych (SDF) za pomocą interfejsu Display & Video 360 API.

Ten program pilotażowy umożliwia każdemu zarejestrowanemu projektowi Google Cloud przesyłanie maksymalnie 5 plików SDF dziennie w ramach konta reklamodawcy.

Instrukcje korzystania z funkcji pilotażowej znajdziesz w przewodniku Przesyłanie plików SDF.

Rozpocznij

Po rozpoczęciu korzystania z interfejsu Display & Video 360 API wykonaj te czynności, aby korzystać z funkcji w ramach programu pilotażowego.

Rejestrowanie projektu Google Cloud w programie pilotażowym

Jeśli jesteś na tej stronie, Twój projekt Google Cloud powinien być już zarejestrowany w programie pilotażowym.

Jeśli nie otrzymaliśmy od Ciebie identyfikatora projektu Google Cloud ani identyfikatora partnera Display & Video 360, a nasz zespół potwierdził, że zostałeś/-aś dodany/-a do listy dozwolonych, wyślij e-maila na adres [e-mail], aby poprosić o dostęp.

Generowanie klucza interfejsu API

Oprócz standardowych danych logowania do interfejsu Display & Video 360 API musisz użyć klucza interfejsu API. Wygeneruj klucz API dla projektu Google Cloud, aby użyć go w konfiguracji klienta.

Konfigurowanie klienta

Aby uzyskać dostęp do tych funkcji pilotażowych, użyj biblioteki klienta interfejsu API Google dla języka Python.

Aby wysyłać żądania do funkcji w ramach pilotażowych, zainstaluj i skonfiguruj bibliotekę klienta:

Python

1. Zainstaluj pakiet google-api-python-client

   pip install --upgrade google-api-python-client
   

2. Zaimportuj niezbędne biblioteki.

   from google_auth_oauthlib.flow import InstalledAppFlow
   from googleapiclient import discovery

3. Wczytaj plik z tajnymi kluczami klienta i wygeneruj dane uwierzytelniające.

   Uwaga: gdy wykonujesz ten krok po raz pierwszy, w przeglądarce pojawi się prośba o autoryzację. Zanim zaakceptujesz, upewnij się, że logujesz się na konto Google, które ma dostęp do Display & Video 360. Aplikacja będzie autoryzowana do uzyskiwania dostępu do danych w imieniu konta, na którym użytkownik jest zalogowany. Więcej informacji o uprawnieniach użytkowników Display & Video 360 znajdziesz w poradniku Autoryzowanie żądań.

   # Set up a flow object to create the credentials using the
   # client secrets file and OAuth scopes.
   credentials = InstalledAppFlow.from_client_secrets_file(
       path-to-client-secrets-file,
       oauth-scopes).run_local_server()

4. Utwórz obiekt autoryzowanej usługi za pomocą usługi wykrywania.

   api_key = "API_KEY"
   api_name = "displayvideo"
   api_url = f"https://{api_name}.googleapis.com"
   api_version = "v4"
   api_label = "SDF_UPLOAD_ALPHA"
   
   discovery_url = (
       f"{api_url}/$discovery/rest?key={api_key}&version={api_version}&labels={api_label}"
   )
   
   service = discovery.build(api_name, api_version,
                             discoveryServiceUrl=discovery_url,
                             credentials=credentials)

Rozpocznij przesyłanie plików SDF

Aby zacząć przesyłać pliki danych strukturalnych, postępuj zgodnie z instrukcjami podanymi w przewodniku po funkcji.