Configuración de la biblioteca cliente de Python

Instala la biblioteca cliente de Python

Para instalar la biblioteca cliente de Python en tu entorno local, sigue estos pasos:

  1. Extrae el archivo tar de la biblioteca cliente de Python.

  2. Ejecuta el siguiente comando en el mismo directorio:

    python -m pip install .

  3. Sigue las indicaciones que aparecen en la terminal para completar la instalación.

Configuración con un archivo YAML

Puedes especificar un archivo YAML para usar cuando inicialices el cliente que contenga la información de autenticación necesaria para realizar solicitudes. Se accede a este archivo cuando se inicializa un cliente con el método load_from_file. Sigue el ejemplo que se proporciona a continuación cuando crees el archivo YAML para especificar el token de actualización, el ID de cliente y el secreto de cliente.

Para especificar la ubicación en la que se encuentra el archivo search-ads-360.yaml, puedes pasar la ruta de acceso como una cadena al método cuando lo llames:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file("path/to/search-ads-360.yaml")

Si no proporcionas una ruta de acceso, la biblioteca buscará el archivo en el directorio $HOME:

from util_searchads360 import SearchAds360Client
client = SearchAds360Client.load_from_file()

Campos de configuración

La configuración de la biblioteca cliente admite los siguientes campos.

Campos generales:

  • refresh_token: Tu token de actualización de OAuth.
  • client_id: Tu ID de cliente de OAuth.
  • client_secret: Tu secreto de cliente de OAuth.
  • login_customer_id: Consulta la documentación de login-customer-id.

Claves compatibles para flujos de aplicaciones web y de escritorio

Si usas el flujo de aplicaciones web o de escritorio, las claves compatibles son las siguientes:

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_id: INSERT_CLIENT_ID_HERE

# Credential for accessing Google's OAuth servers.
# Provided by console.cloud.google.com.
client_secret: INSERT_CLIENT_SECRET_HERE

# Renewable OAuth credential associated with 1 or more Search Ads accounts.
refresh_token: INSERT_REFRESH_TOKEN_HERE

# Required for manager accounts only: Specify the login customer ID used to
# authenticate API calls. This will be the customer ID of the authenticated
# manager account. You can also specify this later in code if your application
# uses multiple manager account + OAuth pairs.
#
# login_customer_id: INSERT_LOGIN_CUSTOMER_ID_HERE