Migracja z wersji 1 do wersji 2

Ostatnia aktualizacja: 6.12.2022

Migracja aplikacji

Migracja z wersji 1 do 2 wymaga zaktualizowania adresów URL punktów końcowych, tak aby wywoływały wersje v2 na zaktualizowanie aplikacji tak, aby uwzględnić zmiany powodujące niezgodność.

Zaktualizuj wywołania interfejsu API z wersji 1 do 2

Aby używać wersji 2 zamiast 1, musisz zaktualizować żądania tak, aby używały nowej wersji 2 i punktów końcowych.

Aby na przykład wywołać metodę advertisers.get z wersją 1, musisz wykonać użyj tego adresu URL:

GET https://displayvideo.googleapis.com/v1/advertisers/advertiserId

W przypadku wersji 2 zaktualizuj adres URL do postaci:

GET https://displayvideo.googleapis.com/v2/advertisers/advertiserId

Jeśli używasz biblioteki klienta do wysyłania żądań do interfejsu API, użyj najczęściej należy zaktualizować bibliotekę klienta i zaktualizować konfigurację, aby korzystała z wersji v2.

Wprowadzanie wymaganych zmian

W wersji 2 wprowadzamy szereg zmian powodujących niezgodność. Zapoznaj się z tymi informacjami: instrukcji i wprowadź wymagane zmiany odpowiednio do istniejącego sposobu korzystania Reklamy displayowe i Interfejs Video 360 API.

Zaktualizuj wywołania metod kierowania

• Niektóre typy kierowania są teraz przypisywane na podstawie wartości wyliczeniowych, a nie kierowania identyfikatorów opcji. Na przykład na tablety są teraz kierowane bezpośrednio reklamy DEVICE_TYPE_TABLET DeviceType Wyliczenie, zamiast identyfikatora opcji kierowania z Usługa targetingTypes.targetingOptions. Wersje w postaci ciągu znaków te wyliczenia są reprezentowane w nowym interfejsie assignedTargetingOptionIdAlias w tych AssignedTargetingOption zasobów i można ich używać podczas pobierania lub lub usunąć istniejące ustawienia kierowania. Wartość assignedTargetingOptionId z tych AssignedTargetingOption zasobów nie uległo zmianie.

  Aby używać wartości wyliczeniowych, zaktualizuj wywołania zarządzające tymi typami kierowania:

  • TARGETING_TYPE_AGE_RANGE
  • TARGETING_TYPE_CONTENT_INSTREAM_POSITION
  • TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION
  • TARGETING_TYPE_DEVICE_TYPE
  • TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
  • TARGETING_TYPE_ENVIRONMENT
  • TARGETING_TYPE_EXCHANGE
  • TARGETING_TYPE_GENDER
  • TARGETING_TYPE_HOUSEHOLD_INCOME
  • TARGETING_TYPE_NATIVE_CONTENT_POSITION
  • TARGETING_TYPE_OMID
  • TARGETING_TYPE_PARENTAL_STATUS
  • TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
  • TARGETING_TYPE_VIDEO_PLAYER_SIZE
  • TARGETING_TYPE_VIEWABILITY

• Metoda advertisers.lineItems.bulkEditLineItemAssignedTargetingOptions Wartość została zastąpiona metodą advertisers.lineItems.bulkEditAssignedTargetingOptions

• Metoda advertisers.lineItems.bulkListLineItemAssignedTargetingOptions Wartość została zastąpiona metodą advertisers.lineItems.bulkListAssignedTargetingOptions

• Zaktualizuj ustawienia zarządzania połączeniami TARGETING_TYPE_PROXIMITY_LOCATION_LIST aby użyć ustawionego rozmiaru promienia oraz jednostka odległości zamiast Wartość wyliczeniowa ProximityRadiusRange.

• Metody kierowania, które pobierają lub edytują opcje kierowania w wielu Zmieniono nazwy typów kierowania w ramach jednego zasobu nadrzędnego.

  Zaktualizuj wywołania tych metod, aby korzystały z nowych nazw:

  • advertisers.bulkEditAdvertiserAssignedTargetingOptions – advertisers.editAssignedTargetingOptions
  • advertisers.bulkListAdvertiserAssignedTargetingOptions – advertisers.listAssignedTargetingOptions
  • advertisers.campaigns.bulkListCampaignAssignedTargetingOptions – advertisers.campaigns.listAssignedTargetingOptions
  • advertisers.insertionOrders.bulkListInsertionOrderAssignedTargetingOptions – advertisers.insertionOrders.listAssignedTargetingOptions .
  • partners.bulkEditPartnerAssignedTargetingOptions do partners.editAssignedTargetingOptions

Zaktualizuj wywołania usługi advertisers.lineItems

• Pole inventorySourceIds zostało usunięte. Zarządzaj przypisanie źródła zasobów reklamowych za pomocą zasobów AssignedTargetingOption z TARGETING_TYPE_INVENTORY_SOURCE.

• Następujące wartości wyliczeniowe LineItemWarningMessage mają zostało wycofane w wersji 2 i nie będzie już wyświetlane LineItem.warningMessages:

  • NO_POSITIVE_AUDIENCE_LIST_TARGETED
  • APP_INSTALL_NO_CONVERSION_PIXEL
  • TARGETING_REVOKED_OR_CLOSED_USER_LIST
  • APP_INSTALL_NO_OPTIMAL_BIDDING_STRATEGY
  • CREATIVE_SIZE_NOT_IN_USE_FOR_TARGETED_DEALS
  • NO_CREATIVE_FOR_TARGETED_DEALS
  • TARGETING_DEPRECATED_GEO_TARGET

• Pole triggerId zostało usunięte z tabeli LineItemFlight oraz Usunięto wartość LINE_ITEM_FLIGHT_DATE_TYPE_TRIGGER z Typ wyliczenia LineItemFlightDateType. Wersja 2 nie obsługuje ustawienie wydatków na elementy zamówienia na podstawie aktywacji reguł ręcznych.

Zaktualizuj wywołania usługi customBiddingAlgorithms

customBiddingAlgorithmState i modelReadiness pola zostały zastąpione modelDetails , które zawiera informacje o gotowości i zawieszenie obecnego algorytmu dla każdego reklamodawcy, który ma dostęp za pośrednictwem listy CustomBiddingModelDetails.

Dodatkowe zmiany

Oprócz wymienionych powyżej zmian powodujących niezgodność wersja 2 wprowadza także funkcje zabezpieczeń.

Funkcje dodane do wersji 2 po jej wprowadzeniu można znaleźć w informacje o wersji.

Dostęp tylko do odczytu do elementów zamówienia YouTube

W wersji 2 elementy zamówienia YouTube i ich ustawienia kierowania można pobierać za pomocą advertisers.lineItems oraz advertisers.lineItems.targetingTypes.assignedTargetingOptions usług Google. Zapewnia dostęp tylko do odczytu, co oznacza, że każdy Próba zapisu w tych elementach zamówienia zwraca błąd. YouTube elementy zamówienia będą mieć jeden z tych parametrów: LineItemType wartości:

• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_ACTION
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_AUDIO
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_NON_SKIPPABLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_REACH_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_SIMPLE_OVER_THE_TOP
• LINE_ITEM_TYPE_YOUTUBE_AND_PARTNERS_VIDEO_SEQUENCE

Nowe metody zwiększające skuteczność

W wersji 2 usługa advertisers.lineItems zapewnia nowe zamiast żądań zbiorczych, które pozwalają lepiej wydajność i mniejsze wykorzystanie limitów:

• Za pomocą advertisers.lineItems.bulkUpdate możesz określić tych samych wartości pól dla wielu elementów zamówienia. Dotyczy to tylko aktualizacji Pole entityStatus jest obecnie obsługiwane.
• Za pomocą advertisers.lineItems.bulkEditAssignedTargetingOptions do dodawania lub usuwania tych samych przypisanych opcji kierowania w wielu wierszach elementy(ów).
• Za pomocą advertisers.lineItems.bulkListAssignedTargetingOptions aby wyświetlić listę przypisanych opcji kierowania dla wielu elementów zamówienia.
• Możesz użyć advertisers.lineItems.duplicate, aby utworzyć duplikat elementu zamówienia w tym samym zamówieniu reklamowym, kopiując wszystkie konfiguracji i ustawień kierowania.

Częściowy dostęp do zapisu w przypadku kierowania zamówień reklamowych

W wersji 2 możesz edytować ustawienia kierowania na podzbiory w przypadku InsertionOrder przy użyciu nowych create oraz delete metod w advertisers.insertionOrders.targetingTypes.assignedTargetingOptions posprzedażna. Po wstawieniu można w pełni zarządzać tymi typami kierowania poziom zamówienia:

• TARGETING_TYPE_AGE_RANGE
• TARGETING_TYPE_BROWSER
• TARGETING_TYPE_CATEGORY
• TARGETING_TYPE_CHANNEL
• TARGETING_TYPE_DEVICE_MAKE_MODEL
• TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION
• TARGETING_TYPE_ENVIRONMENT
• TARGETING_TYPE_GENDER
• TARGETING_TYPE_KEYWORD
• TARGETING_TYPE_LANGUAGE
• TARGETING_TYPE_NEGATIVE_KEYWORD_LIST
• TARGETING_TYPE_OPERATING_SYSTEM
• TARGETING_TYPE_PARENTAL_STATUS
• TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION
• TARGETING_TYPE_VIEWABILITY