Zu einer neuen Version migrieren

Regelmäßig werden neue Versionen der Campaign Manager 360 API veröffentlicht. Mit der Veröffentlichung neuer Versionen werden ältere Versionen verworfen und schließlich eingestellt. Wenn eine Version eingestellt wird, geben alle Anfragen an diese Version Fehler zurück.

Wenn die von Ihnen verwendete Version verworfen wurde, müssen Sie so schnell wie möglich ein Upgrade durchführen, um Dienstunterbrechungen zu vermeiden.

Schritt 1: Ermitteln, welche Version Sie verwenden

Anhand der folgenden Anleitung können Sie ermitteln, welche API-Version Sie verwenden. In den meisten Fällen greifen Sie über eine unserer sprachspezifischen Clientbibliotheken oder eine offizielle Integration auf die API zu.

Neuer Apps Script-Editor

Versionsinformationen für Apps Script werden im Dialogfeld „Erweiterte Dienste“ angezeigt:

  1. Klicken Sie im Apps Script-Editor auf Dienst hinzufügen .
  2. Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
  3. Der im Drop-down-Menü „Version“ ausgewählte Wert ist die verwendete Version der Campaign Manager 360 API.

Alter Apps Script-Editor

Versionsinformationen für Apps Script werden im Dialogfeld „Erweiterte Dienste“ angezeigt:

  1. Gehen Sie im Apps Script-Editor zu Ressourcen > Erweiterte Google-Dienste.
  2. Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
  3. Der im Drop-down-Menü „Version“ ausgewählte Wert ist die verwendete Version der Campaign Manager 360 API.

C#

Versionsinformationen für die Google API-Clientbibliothek für .NET werden an folgenden Stellen angezeigt:

  1. Im NuGet-Paketnamen und im Dienst-Namespace enthalten. 
    Google.Apis.Dfareporting.v5
  2. Über eine öffentliche Eigenschaft von DfareportingService verfügbar. 
    Console.WriteLine(DfareportingService.Version);

Java

Versionsinformationen für die Google API-Clientbibliothek für Java werden an folgenden Stellen angezeigt:

  1. In der Maven-artifactId angegeben. 
    <dependency> <groupId>com.google.apis</groupId>
<artifactId>google-api-services-dfareporting</artifactId>
<version>v5-rev20260213-2.0.0</version>
</dependency>
  2. Im JAR-Dateinamen enthalten. 
    google-api-services-dfareporting-v5-rev20260213-2.0.0.jar
  3. Über eine öffentliche Eigenschaft von Dfareporting verfügbar. 
    System.out.println(Dfareporting.DEFAULT_SERVICE_PATH);

PHP

Versionsinformationen für die Google API-Clientbibliothek für PHP werden über eine öffentliche Eigenschaft von Google_Service_Dfareporting verfügbar gemacht: 

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

Python

Die Google API-Clientbibliothek für Python (Version 1/2) ist nicht versioniert. Die zu verwendende API-Version wird als Argument für den Discovery-Builder angegeben: 

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

Ruby

Versionen der Google API-Clientbibliothek für Ruby vor 0.9 sind nicht versioniert. Die zu verwendende API-Version wird als Argument für den Dienstkonstruktor angegeben: 

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

Bei Versionen der Google API-Clientbibliothek für Ruby ab 0.9 wird die Version im Dienst-Namespace angezeigt: 

Google.Apis.DfareportingV5

Schritt 2: Status Ihrer Version ermitteln

Im Zeitplan für die Einstellung von Versionen können Sie den Status Ihrer Version ermitteln. Wenn Ihre Version nicht aufgeführt ist, wurde sie eingestellt und wird nicht mehr unterstützt.

Wenn Ihre Version aufgeführt ist, sehen Sie in den Spalten Datum der Einstellung und Datum der endgültigen Einstellung nach:

  • Wenn keine Daten vorhanden sind, wird Ihre Version vollständig unterstützt.
  • Wenn Daten vorhanden sind, wurde Ihre Version eingestellt und wird am angegebenen Datum endgültig eingestellt.

Wenn Ihre Version eingestellt wurde oder endgültig eingestellt wird, müssen Sie zu einer neueren Version migrieren, um Dienstunterbrechungen zu vermeiden. Wir empfehlen, zur neuesten Version zu migrieren, die im Zeitplan aufgeführt ist (ohne Betaversionen), um die Zeit zwischen den Upgrades zu maximieren.

Schritt 3: Upgrade auf eine neuere Version durchführen

Wenn Sie zu einer neueren Version der API migrieren möchten, müssen Sie Ihre Integration aktualisieren oder einen aktualisierten Build Ihrer bevorzugten Clientbibliothek abrufen. Beachten Sie, dass einige Clientbibliotheken möglicherweise einen einzelnen Build bereitstellen, der mit jeder API-Version funktioniert, während andere separate Builds für jede Version haben. Die folgende Liste enthält allgemeine Informationen zum Upgrade für die am häufigsten verwendeten Clientbibliotheken und Integrationen.

Neuer Apps Script-Editor

Google Apps Script unterstützt alle Versionen der Campaign Manager 360 API und ermöglicht es Ihnen, die zu verwendende Version für jedes Skript einzeln auszuwählen. So ändern Sie die von einem bestimmten Skript verwendete Version:

  1. Klicken Sie im Apps Script-Editor auf Dienst hinzufügen .
  2. Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
  3. Ändern Sie die Version der Campaign Manager 360 API über das Drop-down-Menü „Version“.
  4. Klicken Sie auf Hinzufügen , um Ihre Änderungen zu speichern.

Alter Apps Script-Editor

Google Apps Script unterstützt alle Versionen der Campaign Manager 360 API und ermöglicht es Ihnen, die zu verwendende Version für jedes Skript einzeln auszuwählen. So ändern Sie die von einem bestimmten Skript verwendete Version:

  1. Gehen Sie im Apps Script-Editor zu Ressourcen > Erweiterte Google-Dienste.
  2. Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
  3. Ändern Sie die Version der Campaign Manager 360 API über das Drop-down-Menü „Version“.
  4. Klicken Sie auf OK , um Ihre Änderungen zu speichern.

C#

Die Google API-Clientbibliothek für .NET bietet separate Builds für jede Version der Campaign Manager 360 API, die über NuGet verteilt werden. Führen Sie ein Upgrade auf eine Version der Clientbibliothek durch, die der API-Version entspricht, die Sie verwenden möchten.

Eine detaillierte Installationsanleitung und alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.

Java

Die Google API-Clientbibliothek für Java bietet separate Builds für jede Version der Campaign Manager 360 API, die über Maven verteilt werden. Führen Sie ein Upgrade auf eine Version der Clientbibliothek durch, die der API-Version entspricht, die Sie verwenden möchten.

Eine detaillierte Installationsanleitung und alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.

PHP

Die Google API-Clientbibliothek für PHP bietet separate Builds für jede Version der Campaign Manager 360 API, die über Packagist verteilt werden. Führen Sie ein Upgrade auf eine Version der Clientbibliothek durch, die der API-Version entspricht, die Sie verwenden möchten.

Eine detaillierte Installationsanleitung und alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.

Python

Jeder Build der Google API-Clientbibliothek für Python (Version 1/2) unterstützt alle Versionen der Campaign Manager 360 API. Wenn Sie zu einer neuen Version der Campaign Manager 360 API migrieren möchten, aktualisieren Sie den Versionsstring, der als Argument an den Discovery-Builder übergeben wird: 

discovery.build('dfareporting', 'v5', http=http)
 Eine detaillierte Installationsanleitung und alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.

Ruby

Die Google API-Clientbibliothek für Ruby Version 0.8 und niedriger unterstützt alle Versionen der Campaign Manager 360 API. Wenn Sie zu einer neuen Version der Campaign Manager 360 API migrieren möchten, aktualisieren Sie den Versionsstring, der als Argument an den Dienstkonstruktor übergeben wird: 

service = Google::APIClient::Service.new("dfareporting", "v5",
    {
      :application_name => "My application",
      :application_version => '1.0.0',
      :authorization => authorization
    }
)
 Die Google API-Clientbibliothek für Ruby Version 0.9 und höher bietet separate Builds für jede Version der Campaign Manager 360 API, die über RubyGems verteilt werden. Führen Sie ein Upgrade auf eine Version der Clientbibliothek durch, die der API-Version entspricht, die Sie verwenden möchten. Eine detaillierte Installationsanleitung und alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.

REST

Wenn Sie die API direkt über HTTPS aufrufen, aktualisieren Sie den Endpunkt für Ihre Anfragen, um die neue API-Versionsnummer zu verwenden.

Wenn Sie beispielsweise von v4 zu v5 migrieren, ändern Sie die Basis-URL von: 

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

Schritt 4: Versionsunterschiede berücksichtigen

Neue API-Versionen sind nach Möglichkeit abwärtskompatibel. Einige Updates können jedoch wichtige Änderungen enthalten, die eine Änderung Ihres Codes erfordern. Diese Änderungen werden in den Versionshinweisen beschrieben.

Überprüfen Sie bei der Migration die Versionshinweise für jede Version zwischen Ihrer aktuellen Version und der Version, auf die Sie ein Upgrade durchführen. Achten Sie besonders auf die folgenden Abschnitte:

  • Neue Funktionen: Neu hinzugefügte Funktionen. Für die Migration sind keine Codeänderungen erforderlich.
  • Einstellung: Funktionen, die aus der API entfernt wurden. Wenn verfügbar, werden Ersatzfunktionen angegeben.
  • Bekannte Probleme: Änderungen an vorhandenen Funktionen, z. B. umbenannte Felder oder Methoden oder geänderte Validierungslogik.

Wenn Ihre Anwendung Funktionen verwendet, die in den Abschnitten Einstellung oder Bekannte Probleme aufgeführt sind, müssen Sie Ihren Code aktualisieren, um diese Änderungen zu berücksichtigen.

Auf dem Laufenden bleiben

Behalten Sie den Google Ads-Entwicklerblog im Auge, um als Erster über API-Releases, Einstellungen und endgültige Einstellungen informiert zu werden.