Inizia

L'API Campaign Manager 360 fornisce accesso programmatico alle informazioni del tuo Account Campaign Manager 360. Viene utilizzato per gestire e creare campagne e report, proprio come faresti con i servizi web Campaign Manager 360 e Report Builder.

Questa guida descrive come iniziare a utilizzare l'API Campaign Manager 360.

Prerequisiti

Prima di utilizzare l'API Campaign Manager 360, devi eseguire alcuni passaggi preliminari soddisfa:

  1. Devi avere un account Campaign Manager 360. Consulta Inserzionisti/agenzie per ottenere informazioni sulla registrazione.

  2. L'account Campaign Manager 360 deve essere abilitato per l'accesso all'API. Più alta negli account è attivata per impostazione predefinita; in caso di dubbi, contatta il tuo il rappresentante dell'account o l'assistenza di Campaign Manager 360 di assistenza.

  3. Devi avere un profilo utente con accesso a questo account. Fai in modo che la tua L'amministratore dell'account Campaign Manager 360 crea un profilo utente associato a questo account.

  4. Controlla le autorizzazioni del profilo utente nell'interfaccia utente di Campaign Manager 360. Questi controlli gli elementi a cui il profilo utente può accedere dall'API. Non esistono API separate autorizzazioni aggiuntive.

Creare un progetto

Per iniziare a utilizzare l'API Campaign Manager 360, devi prima creare oppure seleziona un progetto nella console API di Google e abilita l'API. Utilizzo di questo ti guiderà nella procedura e attiva l'API Campaign Manager 360 automaticamente.

Genera credenziali

Tutte le richieste inviate all'API Campaign Manager 360 devono essere autorizzate. In breve panoramica sull'autorizzazione, scopri come autorizzare e identificare a Google.

Le seguenti istruzioni ti guidano nella procedura di creazione di un token OAuth ID client 2.0 da utilizzare con l'applicazione installata il flusso di lavoro. Per istruzioni sulla generazione delle credenziali da utilizzare al flusso degli account di servizio, fai riferimento alla sezione Account di servizio guida.

  1. Segui i passaggi per configurare un progetto della console API di Google.

  2. Apri la pagina Credenziali nella console API.
  3. Fai clic su CREA CREDENZIALI > ID client OAuth.

    1. Se non hai configurato una schermata per il consenso OAuth per questo progetto ti verrà chiesto di farlo ora. Fai clic su CONFIGURA CONSENSO SCHERMO.

    2. Seleziona il tipo di utente e fai clic su CREA.

    3. Compila il modulo iniziale. Se necessario, puoi modificarlo in un secondo momento. Clic Al termine, salva.

    4. Torna a Credenziali > CREA CREDENZIALI > ID client OAuth su continua.

  4. Seleziona App desktop come tipo di applicazione, assegnale un nome e fai clic su Crea.

Al termine, verranno visualizzati un ID client e un client OAuth 2.0 , che puoi scaricare in formato JSON e salvare per un utilizzo futuro.

Installa una libreria client

L'API Campaign Manager 360 si basa su HTTP e JSON, pertanto qualsiasi client HTTP standard può inviare e analizzare le risposte.

Tuttavia, le librerie client delle API di Google offrono una migliore integrazione del linguaggio, maggiore sicurezza e supporto per le richieste autorizzate. Il cliente le librerie sono disponibili in una serie di linguaggi di programmazione; utilizzandoli evitare di dover impostare manualmente le richieste HTTP e analizzare le risposte.

Per iniziare, seleziona il linguaggio di programmazione che utilizzi sviluppo del prodotto.

C#

Installa la libreria client dell'API di Campaign Manager 360 per .NET più recente. Utilizzo È consigliabile utilizzare NuGet per gestire l'installazione.

Apri la console di gestione dei pacchetti NuGet ed esegui questo comando:

Install-Package Google.Apis.Dfareporting.v3_4

Scopri di più

Java

Installa la libreria client dell'API di Campaign Manager 360 per Java più recente. Utilizzo È consigliabile utilizzare Maven per gestire l'installazione.

Aggiungi la seguente dipendenza al file pom.xml:

<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>

Scopri di più

PHP

Installa la libreria client dell'API Campaign Manager 360 per PHP più recente. Utilizzo Si consiglia di utilizzare Composer per gestire l'installazione.

Apri un terminale ed esegui questo comando:

composer require google/apiclient

Se hai già installato la libreria e vuoi semplicemente eseguire l'aggiornamento alla ultima versione:

composer update google/apiclient

A seconda del sistema, potrebbe essere necessario anteporre questi comandi sudo.

Scopri di più

Python

Installa la libreria client API di Campaign Manager 360 per Python più recente. Utilizzo pip per gestire l'installazione.

Apri un terminale ed esegui questo comando:

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

A seconda del sistema, potrebbe essere necessario anteporre questi comandi sudo.

Scopri di più

Ruby

Installa la libreria client dell'API Campaign Manager 360 per Ruby più recente. Utilizzo Si consiglia di utilizzare RubyGems per gestire l'installazione.

Apri un terminale ed esegui questo comando:

gem install google-api-client

Se hai già installato la libreria e vuoi semplicemente eseguire l'aggiornamento alla ultima versione:

gem update -y google-api-client

A seconda del sistema, potrebbe essere necessario anteporre questi comandi sudo.

Scopri di più

Altre lingue supportate sono disponibili sul Cliente Biblioteche.

Fai una richiesta

Con la creazione di credenziali OAuth 2.0 e una libreria client. , puoi iniziare a utilizzare l'API Campaign Manager 360. Scopri come fare per autorizzare, configurare il client ed effettuare la prima richiesta seguendo consulta la guida rapida riportata di seguito.

C#

  1. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questa operazione ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che dispone dell'accesso a Campaign Manager 360. L'applicazione sarà autorizzata ad accedere ai dati per conto dell'account a cui è stato effettuato l'accesso.

    // 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. Crea un client Dfareporting autorizzato.

    // 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. Esegui un'operazione.

    // 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. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questa operazione ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che dispone dell'accesso a Campaign Manager 360. L'applicazione sarà autorizzata ad accedere ai dati per conto dell'account a cui è stato effettuato l'accesso.

    // 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. Crea un client Dfareporting autorizzato.

    // 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. Esegui un'operazione.

    // 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. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questa operazione ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che dispone dell'accesso a Campaign Manager 360. L'applicazione sarà autorizzata ad accedere ai dati per conto dell'account a cui è stato effettuato l'accesso.

    // 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. Crea un client Dfareporting autorizzato.

    // Create a Dfareporting service object.
    $service = new Google_Service_Dfareporting($client);
    
  3. Esegui un'operazione.

    // 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. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questa operazione ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che dispone dell'accesso a Campaign Manager 360. L'applicazione sarà autorizzata ad accedere ai dati per conto dell'account a cui è stato effettuato l'accesso.

    # 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. Crea un client Dfareporting autorizzato.

    # Construct a service object via the discovery service.
    service = discovery.build('dfareporting', 'v4', http=http)
    
  3. Esegui un'operazione.

    # 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. Carica il file dei client secret e genera le credenziali di autorizzazione.

    La prima volta che esegui questa operazione ti verrà chiesto di accettare una richiesta di autorizzazione nel browser. Prima di accettare, assicurati di aver eseguito l'accesso con un Account Google che dispone dell'accesso a Campaign Manager 360. L'applicazione sarà autorizzata ad accedere ai dati per conto dell'account a cui è stato effettuato l'accesso.

    # 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. Crea un client Dfareporting autorizzato.

    # 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. Esegui un'operazione.

    // 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);
    }
    

Scopri di più

Consulta la pagina Riferimento API per informazioni su tutti i servizi disponibili che l'API ha da offrire. Ogni pagina dei dettagli del metodo ha un'API Spazio di esplorazione che puoi utilizzare per effettuare richieste di test direttamente dal tuo del browser.

Consulta le nostre altre guide che trattano argomenti avanzati e forniscono informazioni complete esempi di attività comuni.

Quando sei pronto a iniziare a scrivere il codice, ti invitiamo a esplorare la nostra vasta di esempi di codice, che possono essere modificati esteso per soddisfare le tue esigenze.