Migracja do nowej wersji

Nowe wersje interfejsu Campaign Manager 360 API są publikowane regularnie. Wraz z udostępnianiem nowych wersji starsze wersje są wycofywane, a następnie wyłączane. Gdy wersja zostanie wyłączona, wszystkie żądania wysyłane do tej wersji zaczną zwracać błędy.

Jeśli używana przez Ciebie wersja jest wycofana, musisz jak najszybciej przejść na nowszą, aby uniknąć przerw w działaniu usługi.

Krok 1. Sprawdź, której wersji używasz

Aby sprawdzić, której wersji interfejsu API używasz, postępuj zgodnie z tymi instrukcjami. W większości przypadków będziesz uzyskiwać dostęp do interfejsu API za pomocą jednej z naszych bibliotek klienta w określonym języku lub oficjalnej integracji.

Nowy edytor Apps Script

Informacje o wersji Apps Script są dostępne w oknie usług zaawansowanych:

  1. W edytorze skryptów Apps Script kliknij Dodaj usługę .
  2. Na liście dostępnych usług znajdź interfejs Campaign Manager 360 API.
  3. Wartość wybrana w menu wersji to używana wersja interfejsu Campaign Manager 360 API.

Starszy edytor Apps Script

Informacje o wersji Apps Script są dostępne w oknie usług zaawansowanych:

  1. W edytorze skryptów Apps Script kliknij Zasoby > Zaawansowane usługi Google.
  2. Na liście dostępnych usług znajdź interfejs Campaign Manager 360 API.
  3. Wartość wybrana w menu wersji to używana wersja interfejsu Campaign Manager 360 API.

C#

Informacje o wersji biblioteki klienta interfejsu API Google dla języka .NET są dostępne w tych miejscach:

  1. W nazwie pakietu NuGet i przestrzeni nazw usługi. 
    Google.Apis.Dfareporting.v5
  2. Za pomocą właściwości publicznej DfareportingService. 
    Console.WriteLine(DfareportingService.Version);

Java

Informacje o wersji biblioteki klienta interfejsu API Google dla języka Java są dostępne w tych miejscach:

  1. W artefakcie Maven. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v5-rev20260213-2.0.0</version>
</dependency>
  2. W nazwie pliku JAR. 
    google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
  3. Za pomocą właściwości publicznej Dfareporting. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Informacje o wersji biblioteki klienta interfejsu API Google dla języka PHP są dostępne za pomocą właściwości publicznej Google_Service_Dfareporting: 

$service = new Google_Service_Dfareporting($client) print
$service->version;

Python

Biblioteka klienta interfejsu API Google dla języka Python (w wersji 1 lub 2) nie jest wersjonowana. Wersję interfejsu API, której chcesz używać, określ jako argument konstruktora wykrywania: 

discovery.build('dfareporting', 'v5', http=http)

Ruby

Biblioteka klienta interfejsu API Google dla języka Ruby w wersji < 0.9 nie jest wersjonowana. Wersję interfejsu API, której chcesz używać, określ jako argument konstruktora usługi: 

service = Google::APIClient::Service.new("dfareporting", "v5", { :application_name => "My application",
:application_version => '1.0.0', :authorization => authorization } )

W przypadku biblioteki klienta interfejsu API Google dla języka Ruby w wersji >= 0.9 wersja jest dostępna w przestrzeni nazw usługi: 

Google.Apis.DfareportingV5

Krok 2. Sprawdź stan swojej wersji

Aby sprawdzić stan swojej wersji, zapoznaj się z harmonogramem wycofywania. Jeśli Twojej wersji nie ma na liście, została ona wyłączona i nie jest już obsługiwana.

Jeśli Twoja wersja jest na liście, sprawdź kolumny Data wycofania i Data wyłączenia:

  • Jeśli nie ma dat, Twoja wersja jest w pełni obsługiwana.
  • Jeśli są daty, Twoja wersja jest wycofana i zostanie wyłączona w podanym dniu.

Jeśli Twoja wersja jest wycofana lub została wyłączona, musisz przejść na nowszą, aby uniknąć przerw w działaniu usługi. Aby zmaksymalizować czas między uaktualnieniami, zalecamy przejście na najnowszą wersję widoczną w harmonogramie (z wyłączeniem wersji beta).

Krok 3. Uaktualnij wersje

Aby przejść na nowszą wersję interfejsu API, musisz zaktualizować integrację lub pobrać zaktualizowaną kompilację preferowanej biblioteki klienta. Pamiętaj, że niektóre biblioteki klienta mogą udostępniać jedną kompilację, która działa z dowolną wersją interfejsu API, a inne mają osobne kompilacje dla każdej wersji. Poniższa lista zawiera ogólne informacje o uaktualnianiu najczęściej używanych bibliotek klienta i integracji.

Nowy edytor Apps Script

Google Apps Script obsługuje wszystkie wersje interfejsu Campaign Manager 360 API i umożliwia wybór wersji, której chcesz używać w poszczególnych skryptach. Aby zmienić wersję używaną przez dany skrypt:

  1. W edytorze skryptów Apps Script kliknij Dodaj usługę .
  2. Na liście dostępnych usług znajdź interfejs Campaign Manager 360 API.
  3. Zmień wersję interfejsu Campaign Manager 360 API za pomocą menu wersji.
  4. Aby zapisać zmiany, kliknij Dodaj.

Starszy edytor Apps Script

Google Apps Script obsługuje wszystkie wersje interfejsu Campaign Manager 360 API i umożliwia wybór wersji, której chcesz używać w poszczególnych skryptach. Aby zmienić wersję używaną przez dany skrypt:

  1. W edytorze skryptów Apps Script kliknij Zasoby > Zaawansowane usługi Google.
  2. Na liście dostępnych usług znajdź interfejs Campaign Manager 360 API.
  3. Zmień wersję interfejsu Campaign Manager 360 API za pomocą menu wersji.
  4. Aby zapisać zmiany, kliknij OK.

C#

Biblioteka klienta interfejsu API Google dla języka .NET udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są dystrybuowane za pomocą NuGet. Zaktualizuj bibliotekę klienta do wersji odpowiadającej wersji interfejsu API, której chcesz używać.

Szczegółowe instrukcje instalacji i alternatywne opcje pobierania, znajdziesz w dokumentacji biblioteki klienta.

Java

Biblioteka klienta interfejsu API Google dla języka Java udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są dystrybuowane za pomocą Maven. Zaktualizuj bibliotekę klienta do wersji odpowiadającej wersji interfejsu API, której chcesz używać.

Szczegółowe instrukcje instalacji i alternatywne opcje pobierania, znajdziesz w dokumentacji biblioteki klienta.

PHP

Biblioteka klienta interfejsu API Google dla języka PHP udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są dystrybuowane za pomocą Packagist. Zaktualizuj bibliotekę klienta do wersji odpowiadającej wersji interfejsu API, której chcesz używać.

Szczegółowe instrukcje instalacji i alternatywne opcje pobierania znajdziesz w dokumentacji biblioteki klienta.

Python

Każda kompilacja biblioteki klienta interfejsu API Google dla języka Python (w wersji 1 lub 2) obsługuje wszystkie wersje interfejsu Campaign Manager 360 API. Aby przejść na nową wersję interfejsu Campaign Manager 360 API, zaktualizuj ciąg wersji przekazywany jako argument do konstruktora wykrywania: 

discovery.build('dfareporting', 'v5', http=http)
 Szczegółowe instrukcje instalacji i alternatywne opcje pobierania znajdziesz w dokumentacji biblioteki klienta.

Ruby

Biblioteka klienta interfejsu API Google dla języka Ruby w wersji 0.8 i starszych obsługuje wszystkie wersje interfejsu Campaign Manager 360 API. Aby przejść na nową wersję interfejsu Campaign Manager 360 API, zaktualizuj ciąg wersji przekazywany jako argument do konstruktora usługi: 

service = Google::APIClient::Service.new("dfareporting", "v5",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Biblioteka klienta interfejsu API Google dla języka Ruby w wersji 0.9 i nowszych udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są dystrybuowane za pomocą RubyGems. Zaktualizuj bibliotekę klienta do wersji odpowiadającej wersji interfejsu API, której chcesz używać. Szczegółowe instrukcje instalacji i alternatywne opcje pobierania znajdziesz w dokumentacji biblioteki klienta.

REST

Jeśli wywołujesz interfejs API bezpośrednio za pomocą HTTPS, zaktualizuj punkt końcowy żądań, aby używać nowego numeru wersji interfejsu API.

Na przykład podczas migracji z v4 na v5 zmienisz podstawowy adres URL z: 

https://dfareporting.googleapis.com/dfareporting/v4/...
 na: 
https://dfareporting.googleapis.com/dfareporting/v5/...

Krok 4. Rozwiąż problemy związane z różnicami między wersjami

Nowe wersje interfejsu API są projektowane tak, aby w miarę możliwości były zgodne wstecz. Niektóre aktualizacje mogą jednak zawierać zmiany powodujące niezgodność, które wymagają modyfikacji kodu. Te zmiany są szczegółowo opisane w informacjach o wersji.

Podczas migracji zapoznaj się z informacjami o wersji każdej wersji między bieżącą a tą, na którą się przesiadasz. Zwróć szczególną uwagę na te sekcje:

  • Nowe funkcje: nowo dodane funkcje. Nie wymagają one zmian w kodzie na potrzeby migracji.
  • Wycofane funkcje: funkcje usunięte z interfejsu API. Jeśli dostępne są funkcje zastępcze, są one wymienione.
  • Znane problemy: modyfikacje istniejących funkcji, takie jak zmiana nazw pól lub metod albo zmiana logiki weryfikacji.

Jeśli Twoja aplikacja korzysta z funkcji wymienionych w sekcjach Wycofane funkcje lub Znane problemy , musisz zaktualizować kod, aby uwzględnić te zmiany.

Bądź na bieżąco

Regularnie sprawdzaj Bloga dla programistów Google Ads, aby jako pierwszy dowiadywać się o wydaniach, wycofaniach i wyłączeniach interfejsu API.