Migracja z wersji 3 na wersję 4

Ostatnia aktualizacja: 31.07.2025

Migracja aplikacji

Migracja z wersji 3 do wersji 4 wymaga zaktualizowania adresów URL punktów końcowych, aby wywoływać wersję 4, oraz zaktualizowania aplikacji, aby uwzględnić zmiany powodujące niezgodność.

Aktualizowanie wywołań interfejsu API z wersji 3 do wersji 4

Aby używać wersji 4 zamiast wersji 3, zaktualizuj żądania tak, aby używały nowych punktów końcowych w wersji 4.

Aby na przykład wywołać metodę advertisers.get w wersji 3, użyj tego adresu URL:

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

W przypadku wersji 4 zaktualizuj adres URL do następującego:

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

Jeśli do wysyłania żądań do interfejsu API używasz biblioteki klienta, używaj jej najnowszej wersji i zaktualizuj konfigurację, aby korzystać z wersji 4.

Wprowadzanie wymaganych zmian

W wersji 4 wprowadzamy kilka zmian powodujących niezgodność. Zapoznaj się z poniższymi instrukcjami i wprowadź wymagane zmiany związane z dotychczasowym korzystaniem z interfejsu Display & Video 360 API.

Aktualizowanie wywołań dotyczących zasobów własnych list odbiorców i list odbiorców dostarczonych przez firmę zewnętrzną oraz powiązanego z nimi kierowania

FirstAndThirdPartyAudience zasobów zostało zastąpionych przez FirstPartyAndPartnerAudience zasobów.

Ta zmiana wymaga zaktualizowania tych elementów:

• Odwołania do zasobów FirstAndThirdPartyAudience, które używają nowego zasobu FirstPartyAndPartnerAudience.
• Istniejące żądania dotyczące metod w usłudze w wersji 3 firstAndThirdPartyAudiencesdo nowej usługi w wersji 4 firstPartyAndPartnerAudiences.
• Oczekiwany domyślny rozmiar strony w przypadku żądań firstPartyAndPartnerAudiences.list obejmujących od 100 do 5000 produktów.
• Odwołania do pola firstAndThirdPartyAudienceType w wersji 3 do nowego pola w wersji 4 firstPartyAndPartnerAudienceType z użyciem nowego typu wyliczeniowego FirstPartyAndPartnerAudienceType, w którym stare wartości odpowiadają tym nowym:
  • Od FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_FIRST_PARTY do TYPE_FIRST_PARTY
  • Od FIRST_AND_THIRD_PARTY_AUDIENCE_TYPE_THIRD_PARTY do TYPE_PARTNER

• Odwołania do wartości wyliczeniowej AudienceType LICENSED należy zastąpić jedną z tych nowych, bardziej szczegółowych wartości:

  • THIRD_PARTY
  • COMMERCE
  • LINEAR

• Odwołania do zasobów AssignedTargetingOption w TargetingType TARGETING_TYPE_AUDIENCE_GROUP zastępują pola wersji 3 w AudienceGroupAssignedTargetingOptionDetails tymi nowymi polami wersji 4:

  • excludedFirstAndThirdPartyAudienceGroup z: excludedFirstPartyAndPartnerAudienceGroup
  • includedFirstAndThirdPartyAudienceGroups z: includedFirstPartyAndPartnerAudienceGroups

Aktualizowanie dotychczasowych zbiorczych żądań kierowania na listy w grupach reklam

Nazwa advertisers.adGroups.bulkListAdGroupAssignedTargetingOptions została zmieniona na advertisers.adGroups.bulkListAssignedTargetingOptions. Zaktualizuj dotychczasowe żądania, aby używać nowej nazwy metody.

Dodawanie celu optymalizacji podczas tworzenia zamówień reklamowych

optimizationObjective jest teraz wymaganym polem w zasobie InsertionOrder. Zaktualizuj żądania advertisers.insertionOrders.create, aby sprawdzić, czy to pole jest ustawione.

Usuń odwołania do pola zasobu kreacji publisherReviewStatuses

Pole publisherReviewStatuses zostało usunięte z obiektu ReviewStatusInfo w zasobie Creative po wycofaniu w czerwcu 2024 r.