Comienza a usar la API de informes de Search Ads 360

En las siguientes secciones, se describe cómo comenzar a usar la API de informes de Search Ads 360.

Configura tu proyecto en Google Cloud

Para usar la API de informes de Search Ads 360, debes crear un proyecto para tu aplicación en Google Cloud.

Crea un proyecto de Google

Un proyecto de Google funciona como contenedor de recursos para tus recursos de Google Cloud.

Crea credenciales de OAuth2

La API de Search Ads 360 Reporting usa OAuth 2.0 para la autenticación y la autorización. Las credenciales de OAuth identifican tu app para Google y te permiten generar tokens de OAuth para administrar a los usuarios de Search Ads 360.

Advertencia: Cualquier app de Google Cloud que se use para obtener credenciales para el permiso de informes de Search Ads 360 necesita la verificación de OAuth de Google. La verificación evita que se muestre a los usuarios una pantalla de IU no verificada cuando acceden.

Habilita la API de Search Ads 360 Reporting

Para usar la API, debes habilitar la API de Search Ads 360 Reporting para tu proyecto en la Consola de API de Google.

Habilita la facturación para tu proyecto de forma opcional

No se aplican cargos por usar la API de Search Ads 360 Reporting en Google Cloud. Sin embargo, existe una cuota para la cantidad total de proyectos de Cloud gratuitos de cada cuenta. Si alcanzaste el límite, puedes registrarte para obtener una nueva cuenta de Google que incluya una cuota de proyecto gratuita.

Nota: Si ya tienes habilitada la facturación (por ejemplo, para Google Cloud), debes seleccionar una cuenta de facturación para tu proyecto.

Habilita la pantalla de consentimiento de tu proyecto

Crea, edita o consulta los URIs de redireccionamiento

Descarga una biblioteca cliente

La forma recomendada de conectarse a la API de Search Ads 360 Reporting es usar una biblioteca cliente de la API de Search Ads 360 Reporting.

Descarga la biblioteca cliente de la API de Search Ads 360 Reporting para tu entorno de desarrollo. Sigue las instrucciones específicas del lenguaje sobre cómo configurar el archivo de configuración de tu biblioteca cliente. En la mayoría de los casos, puedes volver a usar tu configuración existente cuando migres a la nueva biblioteca cliente de la API de Search Ads 360 Reporting.

Un cambio importante es el nuevo encabezado login-customer-id. Consulta el encabezado de ID de cliente de acceso para obtener detalles sobre cuándo debes agregarlo a tu configuración.

Realiza tu primera llamada

Una vez que hayas configurado tu biblioteca cliente, podrás realizar tu primera llamada.

Cómo obtener campañas

En tu IDE, ejecuta el siguiente código:

Java

// Copyright 2022 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     https://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

package sample;

import com.beust.jcommander.Parameter;
import com.google.ads.searchads360.v0.lib.SearchAds360Client;
import com.google.ads.searchads360.v0.services.SearchAds360Row;
import com.google.ads.searchads360.v0.services.SearchAds360ServiceClient;
import com.google.ads.searchads360.v0.services.SearchAds360ServiceClient.SearchPagedResponse;
import com.google.ads.searchads360.v0.services.SearchSearchAds360Request;

/** Get campaign details. */
public class GetCampaigns {
  private static final int PAGE_SIZE = 200;

  private static class GetCampaignsParams extends CodeSampleParams {

    @Parameter(names = "--customerId", required = true)
    private String customerId;

    @Parameter(names = "--loginCustomerId")
    private String loginCustomerId;
  }

  public static void main(String[] args) {
    GetCampaignsParams params = new GetCampaignsParams();
    if (!params.parseArguments(args)) {
      // Optional: You may pass the loginCustomerId on the command line or specify a loginCustomerId
      // here (10 digits, no dashes). If neither are set, customerId will be used as
      // loginCustomerId.
      // params.loginCustomerId = Long.parseLong("INSERT_LOGIN_CUSTOMER_ID_HERE");
    }
    final String loginCustomerId = params.loginCustomerId;
    final String customerId = params.customerId;

    try {
      // Creates a SearchAds360Client with the specified loginCustomerId. If there's
      // no loginCustomerId, customerId will be used instead.
      final SearchAds360Client searchAds360Client =
          SearchAds360Client.newBuilder()
              .setLoginCustomerId(loginCustomerId == null ? customerId : loginCustomerId)
              .fromPropertiesFile()
              .build();
      // Creates the Search Ads 360 Service client.
      SearchAds360ServiceClient client = searchAds360Client.create();
      new GetCampaigns().runExample(client, customerId);
    } catch (Exception exception) {
      System.err.printf("Failed with exception: %s%n", exception);
      exception.printStackTrace();
      System.exit(1);
    }
  }

  private void runExample(SearchAds360ServiceClient searchAds360ServiceClient, String customerId) {
    // Creates a query that retrieves all campaigns under the customerId.
    String query = "SELECT campaign.name, campaign.id, campaign.status FROM campaign";
    SearchSearchAds360Request request =
        SearchSearchAds360Request.newBuilder()
            .setCustomerId(customerId)
            .setQuery(query)
            .setPageSize(PAGE_SIZE)
            .build();

    // Issues a search request.
    final SearchPagedResponse searchPagedResponse = searchAds360ServiceClient.search(request);
    for (SearchAds360Row element : searchPagedResponse.iterateAll()) {
      System.out.printf(
          "Campaign found with name '%s', ID %d, and status: %s.%n",
          element.getCampaign().getName(),
          element.getCampaign().getId(),
          element.getCampaign().getStatus());
    }
  }
}

Descarga GetCampaigns.java

Python

#!/usr/bin/env python
# Copyright 2022 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     https://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
"""Retrieves campaigns for a customer using a pagination search request."""

import argparse
import traceback
from google.ads.searchads360.v0.services.types.search_ads360_service import SearchSearchAds360Request
from util_searchads360 import SearchAds360Client

_DEFAULT_PAGE_SIZE = 10000


def main(client, customer_id, page_size) -> None:
  search_ads_360_service = client.get_service()

  query = """
      SELECT
        campaign.name,
        campaign.id,
        campaign.status
      FROM campaign"""

  request = SearchSearchAds360Request()
  request.customer_id = customer_id
  request.query = query
  request.page_size = page_size

  # Issues a search request.
  results = search_ads_360_service.search(request=request)

  for row in results:
    campaign = row.campaign
    print(
        f'campaign "{campaign.name}" has id {campaign.id} and status {campaign.status.name}'
    )


if __name__ == "__main__":
  # SearchAds360Client will read the search-ads-360.yaml configuration file in
  # the home directory if none is specified.
  search_ads_360_client = SearchAds360Client.load_from_file()

  parser = argparse.ArgumentParser(
      description=("Retrieves campaigns for a customer."))
  # Arguments to provide to run the example.
  parser.add_argument(
      "-c",
      "--customer_id",
      type=str,
      required=True,
      help="The Search Ads 360 customer ID (10 digits, no dashes).",
  )

  parser.add_argument(
      "-l",
      "--login_customer_id",
      type=str,
      required=False,
      help="The Search Ads 360 login customer ID (10 digits, no dashes).",
  )

  args = parser.parse_args()

  search_ads_360_client.set_ids(args.customer_id, args.login_customer_id)

  try:
    main(search_ads_360_client, args.customer_id, _DEFAULT_PAGE_SIZE)
  except Exception:  # pylint: disable=broad-except
    traceback.print_exc()

Descarga get_campaigns.py

La consola debería imprimir una lista de las campañas de tu cuenta.

Usa REST

Si decides no usar una biblioteca cliente, debes comprender cómo usar REST.

Si usaste REST con la API anterior de Search Ads 360, tus credenciales seguirán funcionando con la nueva API de Search Ads 360 Reporting. Busca el extremo nuevo y otros detalles en la sección de referencia de REST.

Más información

Más información sobre la API de Search Ads 360 Reporting

• Consultas:

  • Lenguaje de consulta de Search Ads 360
  • Cómo crear informes de búsqueda
  • Cómo recuperar metadatos

• Conceptos:

  • Estructura de la API de Search Ads 360 Reporting
  • Estructura de llamadas de la API de Search Ads 360 Reporting
  • Control de versiones en la API de Search Ads 360 Reporting
  • Bibliotecas cliente para la API de Search Ads 360 Reporting