Migracja do nowej wersji

Nowe wersje interfejsu Campaign Managera 360 API są publikowane regularnie. Wraz z publikowaniem nowych wersji starsze wersje są wycofywane, a w końcu zamykane. Gdy wersja zostanie wycofana, wszystkie żądania dotyczące tej wersji zaczną zwracać błędy.

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

Krok 1. Sprawdź, z której wersji korzystasz

Aby sprawdzić, z której wersji interfejsu API korzystasz, 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 konkretnym języku lub oficjalnej integracji.

Nowy edytor Apps Script

Informacje o wersji Apps Script są widoczne w oknie usług zaawansowanych:

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

Starsza wersja edytora Apps Script

Informacje o wersji Apps Script są widoczne w oknie usług zaawansowanych:

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

C#

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

1. Zawiera nazwę pakietu NuGet i przestrzeń nazw usługi.

   Google.Apis.Dfareporting.v3_4

2. Udostępniane za pomocą publicznej właściwości 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. Określony w parametrze artifactId Maven.

   <dependency> <groupId>com.google.apis</groupId>
   <artifactId>google-api-services-dfareporting</artifactId>
   <version>v3.4-rev1-1.21.0</version>
   </dependency>

2. Zawarty w nazwie pliku JAR.

   google-api-services-dfareporting-v3.4-rev1-1.21.0.jar

3. Udostępniane za pomocą publicznej właściwości Dfareporting.

   System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Informacje o wersji biblioteki klienta interfejsu API Google dla języka PHP są udostępniane za pomocą publicznej właściwości 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 ma wersji. Wersja interfejsu API, która ma być używana, jest określana jako argument konstruktora wykrywania:

discovery.build('dfareporting', 'v3.4', http=http)

Ruby

Biblioteka klienta interfejsu API Google dla języka Ruby w wersjach < 0.9 nie ma numeru wersji. Wersję interfejsu API, której chcesz użyć, podajesz jako argument konstruktora usługi:

service = Google::APIClient::Service.new("dfareporting", "v3.4", { :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 udostępniana w przestrzeni nazw usługi:

Google.Apis.DfareportingV3_4

Krok 2. Sprawdź stan swojej wersji

Sprawdź harmonogram wycofywania, aby określić stan Twojej wersji. Jeśli Twojej wersji nie ma na liście, została ona wycofana i nie jest już obsługiwana.

Jeśli Twoja wersja jest na liście, sprawdź kolumny Data wycofania i Data zakończenia:

• Jeśli nie ma dat, Twoja wersja jest w pełni obsługiwana.
• Jeśli są podane daty, Twoja wersja jest nieaktualna i zostanie wycofana w określonym dniu.

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

Krok 3. Uaktualnij wersje

Aby przejść na nowszą wersję interfejsu API, musisz zaktualizować integrację lub uzyskać zaktualizowaną kompilację wybranej 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 będą miały oddzielne 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 do użycia w poszczególnych skryptach. Aby zmienić wersję używaną przez konkretny skrypt:

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

Starsza wersja edytora Apps Script

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

1. W edytorze Apps Script otwórz Zasoby > Zaawansowane usługi Google.
2. Na liście dostępnych usług znajdź interfejs Campaign Managera 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 Managera 360 API, które są rozpowszechniane za pomocą NuGet. Zaktualizuj bibliotekę klienta do wersji, która odpowiada wersji interfejsu API, z której chcesz korzystać.

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ą rozpowszechniane za pomocą narzędzia Maven. Zaktualizuj bibliotekę klienta do wersji, która odpowiada wersji interfejsu API, z której chcesz korzystać.

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

PHP

Biblioteka klienta interfejsu API Google dla PHP udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są rozpowszechniane 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 narzędzia do wykrywania:

discovery.build('dfareporting', 'v3.4', 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 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", "v3.4",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)

Biblioteka klienta interfejsu API Google dla języka Ruby w wersji 0.9 lub nowszej udostępnia osobne kompilacje dla każdej wersji interfejsu Campaign Manager 360 API, które są rozpowszechniane 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ą protokołu HTTPS, zaktualizuj punkt końcowy w swoich żądaniach, 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/...

do:

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

Krok 4. Różnice w wersjach adresu

Nowe wersje interfejsu API są w miarę możliwości projektowane tak, aby były zgodne wstecznie. Niektóre aktualizacje mogą jednak zawierać zmiany powodujące niezgodność, które wymagają zmodyfikowania kodu. Szczegółowe informacje o tych zmianach znajdziesz w informacji o wersji.

Podczas migracji zapoznaj się z informacjami o wersji każdej wersji między obecną a wersją, na którą chcesz przejść. Zwróć szczególną uwagę na te sekcje:

• Nowe funkcje: nowo dodane funkcje. Migracja nie wymaga zmian w kodzie.
• Wycofane funkcje: funkcje usunięte z interfejsu API. Informacje o funkcji zastępczej są podawane, gdy jest ona dostępna.
• Znane problemy: modyfikacje istniejących funkcji, takie jak zmiana nazwy pól lub metod czy zmiana logiki weryfikacji.

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

Bądź na bieżąco

Regularnie sprawdzaj blog dla programistów Google Ads, aby jako pierwszy dowiadywać się o wersjach interfejsu API, wycofywaniu i wyłączaniu.