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

Ważne: zwiększyliśmy limit przesyłania w przypadku tej funkcji pilotażowej z 5 do 30 plików SDF dziennie na reklamodawcę.

Ten program pilotażowy umożliwia klientom testowanie nowej funkcji interfejsu Display & Video 360 API w wersji beta, która pozwala im przesyłać pliki uporządkowanych danych (SDF) za pomocą interfejsu Display & Video 360 API.

W ramach tego programu pilotażowego każdy zarejestrowany projekt Google Cloud może przesyłać maksymalnie 30 plików SDF dziennie w ramach konta reklamodawcy. Każdy plik może zawierać maksymalnie 10 000 pozycji.

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

Rozpocznij

Po rozpoczęciu korzystania z interfejsu Display & Video 360 API wykonaj te czynności, aby używać funkcji pilotażowych.

Rejestrowanie projektu Google Cloud w programie pilotażowym

Z funkcji pilotażowych mogą korzystać tylko klienci, którzy poprosili o dostęp do programu pilotażowego i go otrzymali.

Ostrzeżenie: obecnie nie rejestrujemy nowych klientów w programie pilotażowym. Nowe prośby o dodanie do programu pilotażowego będą odrzucane.

Zanim zaczniesz korzystać z funkcji pilotażowych, skontaktuj się z przedstawicielem handlowym Google i upewnij się, że Twój identyfikator projektu Google Cloud jest zarejestrowany w programie pilotażowym.

Generowanie klucza interfejsu API

Oprócz standardowych danych logowania do interfejsu Display & Video 360 API musisz używać klucza interfejsu API. Wygeneruj klucz interfejsu API dla projektu Google Cloud, którego będziesz używać w konfiguracji klienta.

Konfigurowanie klienta

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

Aby zainstalować i skonfigurować bibliotekę klienta do wysyłania żądań do funkcji pilotażowych:

Python

1. Instalowanie biblioteki 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 klientów i wygeneruj dane uwierzytelniające.

   Uwaga: gdy wykonasz ten krok po raz pierwszy, w przeglądarce pojawi się prośba o zaakceptowanie autoryzacji. Przed zaakceptowaniem upewnij się, że logujesz się za pomocą konta 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 nastąpiło logowanie. Więcej informacji o uprawnieniach użytkowników Display & Video 360 znajdziesz w naszym przewodniku 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 autoryzowany obiekt 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 rozpocząć przesyłanie plików danych strukturalnych, postępuj zgodnie z instrukcjami w naszym przewodniku po funkcjach.