Jetzt starten

Über die Campaign Manager 360 API erhalten Sie programmatischen Zugriff auf Informationen aus Ihrem Campaign Manager 360-Konto. Sie dient zur Verwaltung und Erstellung von Kampagnen und Berichten. genau wie bei den Webdiensten Campaign Manager 360 und Report Builder.

In diesem Leitfaden werden die ersten Schritte mit der Campaign Manager 360 API beschrieben.

Vorbereitung

Bevor Sie die Campaign Manager 360 API verwenden können, müssen Sie einige Schritte ausführen, erfüllen:

  1. Sie benötigen ein Campaign Manager 360-Konto. Weitere Informationen finden Sie unter Werbetreibende/Agenturen.

  2. Ihr Campaign Manager 360-Konto muss für den API-Zugriff aktiviert sein. Meiste Bei Konten ist dies standardmäßig aktiviert. Wenn Sie sich nicht sicher sind, wenden Sie sich an Ihren Kundenbetreuer oder dem Campaign Manager 360-Support für Unterstützung.

  3. Sie benötigen ein Nutzerprofil mit Zugriff auf dieses Konto. Sorgen Sie dafür, dass Ihr Der Administrator des Campaign Manager 360-Kontos erstellt ein Nutzerprofil, das mit diesem Konto.

  4. Prüfen Sie die Berechtigungen für Nutzerprofile auf der Campaign Manager 360-Benutzeroberfläche. Diese steuern worauf das Nutzerprofil über die API zugreifen kann. Es gibt keine separate API, Berechtigungen.

Projekt erstellen

Um die Campaign Manager 360 API zu verwenden, müssen Sie zuerst erstellen, oder ein Projekt in der Google API Console auswählen und die API aktivieren Mit diesem führt Sie durch den Prozess und aktiviert die Campaign Manager 360 API. automatisch.

<ph type="x-smartling-placeholder">

Anmeldedaten generieren

Alle Anfragen an die Campaign Manager 360 API müssen autorisiert werden. Kurze Beschreibung Übersicht über die Autorisierung finden Sie im Abschnitt zur Autorisierung und Identifizierung Ihres an Google senden.

Die folgende Anleitung führt Sie durch den Prozess zur Erstellung eines OAuth-Vorgangs. 2.0-Client-ID zur Verwendung mit der installierten Anwendung Anweisungen zum Generieren von Anmeldedaten für die Verwendung mit dem Dienstkontoablauf finden Sie unter Dienstkonten .

  1. Führen Sie die Schritte zur Konfiguration eines Google API Console-Projekts aus.

  2. Öffnen Sie in der API Console die Seite Anmeldedaten.
  3. Klicken Sie auf ANMELDEDATEN ERSTELLEN > OAuth-Client-ID

    1. Wenn Sie keinen OAuth-Zustimmungsbildschirm für dieses Projekt konfiguriert haben werden Sie jetzt aufgefordert. Klicken Sie auf ZUSTIMMEN KONFIGURIEREN. BILDSCHIRM.

    2. Wählen Sie den Nutzertyp aus und klicken Sie auf ERSTELLEN.

    3. Füllen Sie das erste Formular aus. Sie können dies später bei Bedarf bearbeiten. Klicken Sie auf Klicken Sie abschließend auf Speichern.

    4. Gehen Sie zurück zu Anmeldedaten > ANMELDEDATEN ERSTELLEN > OAuth-Client-ID für Fortfahren.

  4. Wählen Sie als Anwendungstyp Desktop-App aus, geben Sie einen Namen ein und klicken Sie auf Erstellen:

Danach werden eine OAuth 2.0-Client-ID und ein OAuth 2.0-Client angezeigt. das Sie im JSON-Format herunterladen und zur späteren Verwendung speichern können.

<ph type="x-smartling-placeholder">

Clientbibliothek installieren

Die Campaign Manager 360 API basiert auf HTTP und JSON, daher kann jeder Standard-HTTP-Client und parsen die Antworten.

Die Google API-Client-Bibliotheken bieten jedoch eine bessere Sprachintegration, mehr Sicherheit und Unterstützung für autorisierte Anfragen. Der Kunde Bibliotheken sind in verschiedenen Programmiersprachen verfügbar. indem Sie sie nutzen, können Sie vermeiden, dass Sie HTTP-Anfragen manuell einrichten und die Antworten parsen müssen.

Wählen Sie zunächst die Programmiersprache aus, die Sie für Entwicklung.

C#

Installieren Sie die neueste Campaign Manager 360 API-Clientbibliothek für .NET. Mit Zur Verwaltung der Installation wird NuGet empfohlen.

Öffnen Sie die NuGet-Paket-Manager-Konsole und führen Sie den folgenden Befehl aus:

Install-Package Google.Apis.Dfareporting.v3_4

Weitere Informationen

Java

Installieren Sie die neueste Campaign Manager 360 API-Clientbibliothek für Java. Mit Wir empfehlen, die Installation mit Maven zu verwalten.

Fügen Sie der Datei pom.xml die folgende Abhängigkeit hinzu:

<dependency>
  <groupId>com.google.apis</groupId>
  <artifactId>google-api-services-dfareporting</artifactId>
  <version>v4-rev20220611-1.32.1</version>
  <exclusions>
    <exclusion>
      <groupId>com.google.guava</groupId>
      <artifactId>guava-jdk5</artifactId>
    </exclusion>
  </exclusions>
</dependency>

Weitere Informationen

PHP

Installieren Sie die neueste Campaign Manager 360 API-Clientbibliothek für PHP. Mit Wir empfehlen, die Installation mit Composer zu verwalten.

Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

composer require google/apiclient

Wenn Sie die Bibliothek bereits installiert haben und nur auf die neueste Version:

composer update google/apiclient

Je nach System müssen Sie diesen Befehlen den sudo

Weitere Informationen

Python

Installieren Sie die neueste Campaign Manager 360 API-Clientbibliothek für Python. Mit Wir empfehlen, die Installation mit pip zu verwalten.

Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

pip install --upgrade google-api-python-client

Je nach System müssen Sie diesen Befehlen den sudo

Weitere Informationen

Ruby

Installieren Sie die neueste Campaign Manager 360 API-Clientbibliothek für Ruby. Mit Für die Verwaltung der Installation wird RubyGems empfohlen.

Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

gem install google-api-client

Wenn Sie die Bibliothek bereits installiert haben und nur auf die neueste Version:

gem update -y google-api-client

Je nach System müssen Sie diesen Befehlen den sudo

Weitere Informationen

Weitere unterstützte Sprachen finden Sie auf der Client-Website Bibliotheken.

Anfrage stellen

Mit Erstellung von OAuth 2.0-Anmeldedaten und einer Clientbibliothek installiert haben, können Sie die Campaign Manager 360 API verwenden. Weitere Informationen um Ihren Client zu autorisieren, zu konfigurieren und Ihre erste Anfrage zu stellen, indem Sie erhalten Sie in der Kurzanleitung unten.

C#

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Campaign Manager 360 hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    // Load client secrets from the specified JSON file.
    GoogleClientSecrets clientSecrets;
    using(Stream json = new FileStream(pathToJsonFile, FileMode.Open, FileAccess.Read)) {
      clientSecrets = GoogleClientSecrets.Load(json);
    }
    
    // Create an asynchronous authorization task.
    //
    // Note: providing a data store allows auth credentials to be cached, so they survive multiple
    // runs of the application. This avoids prompting the user for authorization every time the
    // access token expires, by remembering the refresh token. The "user" value is used to
    // identify a specific set of credentials within the data store. You may provide different
    // values here to persist credentials for multiple users to the same data store.
    Task<UserCredential> authorizationTask = GoogleWebAuthorizationBroker.AuthorizeAsync(
        clientSecrets.Secrets,
        OAuthScopes,
        "user",
        CancellationToken.None,
        dataStore);
    
    // Authorize and persist credentials to the data store.
    UserCredential credential = authorizationTask.Result;
    
  2. Erstellen Sie einen autorisierten DFA-Berichtsclient.

    // Create a Dfareporting service object.
    //
    // Note: application name should be replaced with a value that identifies your application.
    service = new DfareportingService(
        new BaseClientService.Initializer {
          HttpClientInitializer = credential,
          ApplicationName = "C# installed app sample"
        }
    );
    
  3. Führen Sie einen Vorgang aus.

    // Retrieve and print all user profiles for the current authorized user.
    UserProfileList profiles = service.UserProfiles.List().Execute();
    
    foreach (UserProfile profile in profiles.Items) {
      Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
          profile.ProfileId, profile.UserName);
    }
    

Java

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Campaign Manager 360 hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    // Load the client secrets JSON file.
    GoogleClientSecrets clientSecrets =
        GoogleClientSecrets.load(
            jsonFactory, Files.newBufferedReader(Paths.get(pathToClientSecretsFile), UTF_8));
    
    // Set up the authorization code flow.
    //
    // Note: providing a DataStoreFactory allows auth credentials to be cached, so they survive
    // multiple runs of the program. This avoids prompting the user for authorization every time the
    // access token expires, by remembering the refresh token.
    GoogleAuthorizationCodeFlow flow =
        new GoogleAuthorizationCodeFlow.Builder(
                httpTransport, jsonFactory, clientSecrets, OAUTH_SCOPES)
            .setDataStoreFactory(dataStoreFactory)
            .build();
    
    // Authorize and persist credentials to the data store.
    //
    // Note: the "user" value below is used to identify a specific set of credentials in the data
    // store. You may provide different values here to persist credentials for multiple users to
    // the same data store.
    Credential credential =
        new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
    
  2. Erstellen Sie einen autorisierten DFA-Berichtsclient.

    // Create a Dfareporting client instance.
    //
    // Note: application name below should be replaced with a value that identifies your
    // application. Suggested format is "MyCompany-ProductName/Version.MinorVersion".
    Dfareporting reporting =
        new Dfareporting.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
            .setApplicationName("dfareporting-java-installed-app-sample")
            .build();
    
  3. Führen Sie einen Vorgang aus.

    // Retrieve and print all user profiles for the current authorized user.
    UserProfileList profiles = reporting.userProfiles().list().execute();
    for (int i = 0; i < profiles.getItems().size(); i++) {
      System.out.printf("%d) %s%n", i + 1, profiles.getItems().get(i).getUserName());
    }
    

PHP

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Campaign Manager 360 hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    // Create a Google_Client instance.
    //
    // Note: application name should be replaced with a value that identifies
    // your application. Suggested format is "MyCompany-ProductName".
    $client = new Google_Client();
    $client->setAccessType('offline');
    $client->setApplicationName('PHP installed app sample');
    $client->setRedirectUri(self::OAUTH_REDIRECT_URI);
    $client->setScopes(self::$OAUTH_SCOPES);
    
    // Load the client secrets file.
    $client->setAuthConfig($pathToJsonFile);
    
    // Try to load cached credentials from the token store. Using a token store
    // allows auth credentials to be cached, so they survive multiple runs of
    // the application. This avoids prompting the user for authorization every
    // time the access token expires, by remembering the refresh token.
    if (file_exists($tokenStore) && filesize($tokenStore) > 0) {
        $client->setAccessToken(file_get_contents($tokenStore));
    } else {
        // If no cached credentials were found, authorize and persist
        // credentials to the token store.
        print 'Open this URL in your browser and authorize the application.';
        printf("\n\n%s\n\n", $client->createAuthUrl());
        print 'Enter the authorization code: ';
        $code = trim(fgets(STDIN));
        $client->authenticate($code);
    
        file_put_contents($tokenStore, json_encode($client->getAccessToken()));
    }
    
  2. Erstellen Sie einen autorisierten DFA-Berichtsclient.

    // Create a Dfareporting service object.
    $service = new Google_Service_Dfareporting($client);
    
  3. Führen Sie einen Vorgang aus.

    // Retrieve and print all user profiles for the current authorized user.
    $result = $service->userProfiles->listUserProfiles();
    foreach ($result['items'] as $userProfile) {
        printf(
            "User profile \"%s\" (ID: %d) found for account %d.\n",
            $userProfile->getUserName(),
            $userProfile->getProfileId(),
            $userProfile->getAccountId()
        );
    }
    

Python

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Campaign Manager 360 hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    # Set up a Flow object to be used if we need to authenticate.
    flow = client.flow_from_clientsecrets(
        path_to_client_secrets_file, scope=OAUTH_SCOPES)
    
    # Check whether credentials exist in the credential store. Using a credential
    # store allows auth credentials to be cached, so they survive multiple runs
    # of the application. This avoids prompting the user for authorization every
    # time the access token expires, by remembering the refresh token.
    storage = Storage(CREDENTIAL_STORE_FILE)
    credentials = storage.get()
    
    # If no credentials were found, go through the authorization process and
    # persist credentials to the credential store.
    if credentials is None or credentials.invalid:
      credentials = tools.run_flow(flow, storage,
                                   tools.argparser.parse_known_args()[0])
    
    # Use the credentials to authorize an httplib2.Http instance.
    http = credentials.authorize(httplib2.Http())
    
  2. Erstellen Sie einen autorisierten DFA-Berichtsclient.

    # Construct a service object via the discovery service.
    service = discovery.build('dfareporting', 'v4', http=http)
    
  3. Führen Sie einen Vorgang aus.

    # Construct the request.
    request = service.userProfiles().list()
    
    # Execute request and print response.
    response = request.execute()
    
    for profile in response['items']:
      print('Found user profile with ID %s and user name "%s".' %
            (profile['profileId'], profile['userName']))
    

Ruby

  1. Laden Sie die Datei mit den Clientschlüsseln und generieren Sie Anmeldedaten für die Autorisierung.

    Wenn Sie diesen Schritt zum ersten Mal ausführen, werden Sie aufgefordert, eine Autorisierungsaufforderung in Ihrem Browser zu akzeptieren. Bevor Sie zustimmen, müssen Sie mit einem Google-Konto angemeldet sein, das Zugriff auf Campaign Manager 360 hat. Ihre Anwendung wird autorisiert, im Namen des Kontos, in dem Sie gerade angemeldet sind, auf Daten zuzugreifen.

    # Load client ID from the specified file.
    client_id = Google::Auth::ClientId.from_file(path_to_json_file)
    
    # Set up the user authorizer.
    #
    # Note: providing a token store allows auth credentials to be cached, so they
    # survive multiple runs of the application. This avoids prompting the user for
    # authorization every time the access token expires, by remembering the
    # refresh token.
    authorizer = Google::Auth::UserAuthorizer.new(
      client_id, [API_NAMESPACE::AUTH_DFAREPORTING], token_store
    )
    
    # Authorize and persist credentials to the data store.
    #
    # Note: the 'user' value below is used to identify a specific set of
    # credentials in the token store. You may provide different values here to
    # persist credentials for multiple users to the same token store.
    authorization = authorizer.get_credentials('user')
    if authorization.nil?
      puts format(
        "Open this URL in your browser and authorize the application.\n\n%s" \
        "\n\nEnter the authorization code:",
        authorizer.get_authorization_url(base_url: OAUTH_REDIRECT_URI)
      )
      code = STDIN.gets.chomp
      authorization = authorizer.get_and_store_credentials_from_code(
        base_url: OAUTH_REDIRECT_URI, code: code, user_id: 'user'
      )
    end
    
  2. Erstellen Sie einen autorisierten DFA-Berichtsclient.

    # Create a Dfareporting service object.
    #
    # Note: application name should be replaced with a value that identifies
    # your application. Suggested format is "MyCompany-ProductName".
    service = API_NAMESPACE::DfareportingService.new
    service.authorization = authorization
    service.client_options.application_name = 'Ruby installed app sample'
    service.client_options.application_version = '1.0.0'
    
  3. Führen Sie einen Vorgang aus.

    // Retrieve and print all user profiles for the current authorized user.
    UserProfileList profiles = service.UserProfiles.List().Execute();
    
    foreach (UserProfile profile in profiles.Items) {
      Console.WriteLine("Found user profile with ID {0} and name \"{1}\".",
          profile.ProfileId, profile.UserName);
    }
    

Weitere Informationen

In der API-Referenz finden Sie Informationen zu allen Diensten, die API zu bieten hat. Auf jeder Detailseite für die Methode ist eine API eingebettet. Explorer, mit dem Sie Testanfragen direkt über Ihr Browser.

Lesen Sie auch unsere anderen Leitfäden, die Themen für Fortgeschrittene und Beispiele für gängige Aufgaben.

Wenn Sie bereit sind, Code zu schreiben, können Sie sich unsere umfangreichen Sammlung von Codebeispielen, die geändert und an Ihre Bedürfnisse angepasst.