Neue Versionen der Campaign Manager 360 API werden regelmäßig veröffentlicht. Mit der Veröffentlichung neuer Versionen werden ältere Versionen eingestellt und schließlich eingestellt. Wenn eine Version eingestellt wird, werden für alle Anfragen an diese Version Fehler zurückgegeben.
Wenn eine Version der von Ihnen verwendeten API eingestellt wird, müssen Sie vor dem geplanten Einstellungsdatum zu einer neueren Version migrieren. In diesem Leitfaden erfahren Sie, wie Sie feststellen können, ob die von Ihnen verwendete API-Version eingestellt wurde, und welche Migrationsschritte empfohlen werden.
Schritt 1: Version ermitteln
Wenn Sie eine Anwendung verwalten, bei der Sie vermuten, dass eine eingestellte Version der Campaign Manager 360 API verwendet wird, sollten Sie zuerst prüfen, welche Version Sie verwenden. In den meisten Fällen greifen Sie über eine unserer sprachspezifischen Clientbibliotheken oder eine offizielle Integration auf die API zu. Unten finden Sie eine Anleitung zum Finden der API-Version, die von diesen Clientbibliotheken und Integrationen verwendet wird:
Neuer Apps Script-Editor
Versionsinformationen für Apps Script werden im Dialogfeld „Erweiterte Dienste“ angezeigt:
- Klicken Sie im Apps Script-Editor auf Dienst hinzufügen .
- Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
- Der im Drop-down-Menü „Version“ ausgewählte Wert ist die aktuell verwendete Campaign Manager 360 API-Version.
Legacy-Editor für Apps Script
Versionsinformationen für Apps Script werden im Dialogfeld „Erweiterte Dienste“ angezeigt:
- Klicken Sie im App Script-Editor auf Ressourcen > Erweiterte Google-Dienste.
- Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
- Der im Drop-down-Menü „Version“ ausgewählte Wert ist die aktuell verwendete Campaign Manager 360 API-Version.
C#
Versionsinformationen für die Google API-Clientbibliothek für .NET finden Sie an den folgenden Stellen:
- Ist im Namen des NuGet-Pakets und im Dienst-Namespace enthalten.
Google.Apis.Dfareporting.v3_4
- Über eine öffentliche Eigenschaft von
DfareportingServicefreigegeben.Console.WriteLine(DfareportingService.Version);
Java
Versionsinformationen für die Google API-Clientbibliothek für Java finden Sie an den folgenden Stellen:
- Wird in der Maven-Artefakt-ID angegeben.
<dependency> <groupId>com.google.apis</groupId> <artifactId>google-api-services-dfareporting</artifactId> <version>v3.4-rev1-1.21.0</version> </dependency>
- Im JAR-Dateinamen enthalten.
google-api-services-dfareporting-v3.4-rev1-1.21.0.jar
- Über eine öffentliche Eigenschaft von
Dfareportingfreigegeben.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 bereitgestellt:
$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', 'v3.4', http=http)
Ruby
Versionen der Google API-Clientbibliothek für Ruby unter 0.9 sind nicht versioniert. Die zu verwendende API-Version wird als Argument für den Dienstkonstruktor angegeben:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
Bei Versionen der Google API-Clientbibliothek für Ruby > 0.9 wird die Version im Dienstnamensbereich freigegeben:
Google.Apis.DfareportingV3_4
Notieren Sie sich die verwendete Version, da Sie diese Informationen später benötigen.
Schritt 2: Status Ihrer Version ermitteln
Im Zeitplan für die Einstellung ist der Status jeder derzeit unterstützten Version aufgeführt. Suchen Sie in dieser Liste nach Ihrer Version und ermitteln Sie den Status so:
- Wenn in den Spalten Datum der Einstellung und Datum der Einstellung keine Datumsangaben aufgeführt sind, verwenden Sie eine vollständig unterstützte Version.
- Wenn Datumsangaben aufgeführt sind, wird die von Ihnen verwendete Version derzeit eingestellt und am angegebenen Datum eingestellt.
- Wenn Ihre Version nicht aufgeführt ist, wurde sie bereits eingestellt und wird nicht mehr unterstützt.
Wenn Sie zu den Punkten 2 oder 3 oben gehören, müssen Sie zu einer neueren Version migrieren, um Dienstunterbrechungen zu vermeiden. Wir empfehlen, auf die neueste Version zu migrieren, die oben in der Tabelle mit dem Zeitplan für die Einstellung aufgeführt ist (Betaversionen ausgenommen). So haben Sie zwischen den Upgrades möglichst viel Zeit.
Schritt 3: Versionen aktualisieren
Wenn Sie festgestellt haben, dass eine Migration erforderlich ist, aktualisieren Sie als Nächstes Ihre Integration oder holen Sie sich einen aktualisierten Build Ihrer bevorzugten Clientbibliothek. Einige Clientbibliotheken bieten möglicherweise nur einen Build, der mit jeder API-Version funktioniert, während andere separate Builds für jede Version haben. In der folgenden Liste finden Sie 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. Sie können die zu verwendende Version für jedes Script einzeln auswählen. So ändern Sie die Version, die von einem bestimmten Script verwendet wird:
- Klicken Sie im Apps Script-Editor auf Dienst hinzufügen .
- Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
- Ändern Sie die verwendete Campaign Manager 360 API-Version über das Drop-down-Menü „Version“.
- Klicken Sie auf Hinzufügen, um Ihre Änderungen zu speichern.
Legacy-Editor für Apps Script
Google Apps Script unterstützt alle Versionen der Campaign Manager 360 API. Sie können die zu verwendende Version für jedes Script einzeln auswählen. So ändern Sie die Version, die von einem bestimmten Script verwendet wird:
- Klicken Sie im App Script-Editor auf Ressourcen > Erweiterte Google-Dienste.
- Suchen Sie in der Liste der verfügbaren Dienste nach der Campaign Manager 360 API.
- Ändern Sie die verwendete Campaign Manager 360 API-Version über das Drop-down-Menü „Version“.
- Klicken Sie auf OK, um die Ä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.
Eine ausführliche Installationsanleitung oder 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.
Eine ausführliche Installationsanleitung oder 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.
Eine ausführliche Installationsanleitung oder alternative Downloadoptionen finden Sie in der Dokumentation zur Clientbibliothek.
Python
Jede Version der Google API-Clientbibliothek für Python (Version 1/2) unterstützt alle Versionen der Campaign Manager 360 API. Aktualisieren Sie einfach den Versionsstring, der als Argument an den Discovery-Builder übergeben wird:
discovery.build('dfareporting', 'v3.4', http=http)
Ruby
Die Google API-Clientbibliothek für Ruby Version 0.8 und niedriger unterstützt alle Versionen der Campaign Manager 360 API. Aktualisieren Sie einfach den Versionsstring, der als Argument an den Dienstkonstruktor übergeben wird:
service = Google::APIClient::Service.new("dfareporting", "v3.4", { :application_name => "My application", :application_version => '1.0.0', :authorization => authorization } )
Schritt 4: Unterschiede bei Adressversionen
Wir bemühen uns, unsere neuen Releases abwärtskompatibel zu gestalten. Das bedeutet, dass für die Migration zwischen API-Versionen keine Änderungen an Ihrem Code erforderlich sind. Wenn dies nicht möglich ist, werden die Änderungen, die Maßnahmen von Entwicklern erfordern (auch als Breaking Changes bezeichnet), in unseren Release Notes angekündigt.
Sehen Sie sich jetzt unsere Releasenotes an, beginnend mit der Version nach der Version, mit der Sie begonnen haben (die Sie sich in einem früheren Abschnitt notiert haben) und bis einschließlich der Version, auf die Sie ein Upgrade ausführen. Die Abschnitte der Release Notes sollten so interpretiert werden:
- Neue Funktionen: Neu hinzugefügte Funktionen.
- Einstellung: Funktionen, die aus der API entfernt wurden. Sofern verfügbar, werden Ersatzfunktionen in diesem Abschnitt beschrieben.
- Bekannte Probleme: Änderungen, die keine Ergänzungen oder Entfernungen sind. In diesem Abschnitt können beispielsweise Felder oder Methoden behandelt werden, die umbenannt wurden, oder die Validierungslogik, die sich geändert hat.
Für die Funktionen unter Neue Funktionen sind keine Codeänderungen erforderlich und sie können vorerst ignoriert werden. Du kannst später wieder zu diesem Abschnitt zurückkehren, wenn du etwas ausprobieren möchtest, das wir hinzugefügt haben.
Wenn Sie hingegen Änderungen in den Abschnitten Einstellung oder Bekannte Probleme feststellen, müssen Sie möglicherweise Maßnahmen ergreifen. Sie sollten Ihren Code durchsuchen, um festzustellen, ob eine der entfernten oder geänderten Funktionen von Ihrer Anwendung verwendet wird. In diesem Fall müssen Sie Ihren Code entsprechend aktualisieren.
Auf dem Laufenden bleiben
Wie bereits erwähnt, werden neue Versionen der Campaign Manager 360 API regelmäßig veröffentlicht und alte Versionen eingestellt. Informationen zu neuen Releases, eingestellten und eingestellten Produkten werden in den folgenden Kanälen veröffentlicht:
Wir empfehlen Ihnen, einen oder mehrere dieser Kanäle zu abonnieren, um immer über die neuesten API-Neuigkeiten informiert zu sein.