Configura y usa OAuth

Todas las llamadas a la API de Local Services deben autorizarse a través de OAuth 2.0. Esto permite que tu app cliente de la API de Local Services acceda a la cuenta de Anuncios de Servicios Locales de un usuario sin necesidad de controlar ni almacenar su información de acceso.

La API de Servicios Locales usa el protocolo OAuth 2.0 para autenticar a los usuarios. Para obtener más información sobre OAuth 2.0, consulta Usa OAuth 2.0 para acceder a las APIs de Google.

Configura un proyecto de la Consola de APIs de Google para la API de Local Services

Para autenticar y autorizar a los usuarios de Google Ads, debes tener credenciales para acceder a los servidores OAuth 2.0 de Google. Estas credenciales identifican tu aplicación ante Google y te permiten generar tokens de OAuth para administrar usuarios de Google Ads. Usa la Consola de APIs de Google para administrar el acceso a tus credenciales de OAuth 2.0 de Google.

Para recibir estas credenciales, sigue estos pasos:

  1. Crear un proyecto Para ello, navega a la Consola de APIs de Google. Haz clic en Crear proyecto, ingresa un nombre y haz clic en Crear.

  2. Habilita la API de Local Services en tu proyecto:

    1. Abre la Biblioteca de APIs en la Consola de APIs de Google. Si se te solicita, selecciona tu proyecto o crea uno nuevo. La Biblioteca de APIs muestra todas las APIs disponibles, agrupadas por familia de productos y popularidad.

      Si la API de Servicios Locales no aparece en la lista, usa el cuadro de búsqueda para encontrarla.

    2. Selecciona la API de Servicios Locales y, luego, haz clic en Habilitar.

  3. Elige un tipo de app. La API de Local Services usa los mismos tipos de aplicaciones que la API de Google Ads. Para obtener más detalles sobre qué tipo de app usar, consulta Cómo elegir un tipo de app.

  4. Crea un ID de cliente y un secreto del cliente. En el caso de la API de Local Services, sigue los mismos pasos para crear un ID de cliente y un secreto del cliente que los que se usan para la API de Google Ads. Los pasos son idénticos para ambos casos de uso.

Usa la biblioteca cliente para obtener tokens de OAuth 2.0

Para obtener una lista de las bibliotecas cliente que puedes usar para realizar solicitudes de autorización de OAuth 2.0, consulta Bibliotecas cliente. Sigue las instrucciones específicas de la biblioteca para obtener información sobre cómo usar un token de actualización y obtener un token de acceso nuevo.

Cómo obtener un token de actualización de OAuth 2.0

Te recomendamos que uses las bibliotecas cliente en producción para autenticar a los usuarios. Si deseas usar un cliente HTTP para realizar pruebas, sigue las instrucciones que se indican a continuación para obtener un token de actualización y un token de acceso de OAuth 2.0. Los pasos 1, 2 y 3 son instrucciones de configuración únicas que debes realizar de forma manual, y los pasos 4 y 5 se pueden automatizar después para que se ejecuten sin intervención humana, como un trabajo cron.

  1. Descarga e instala curl, una herramienta de línea de comandos para realizar solicitudes web HTTP.

  2. Sigue las instrucciones de la página OAuth Playground para obtener un token de actualización de OAuth 2.0. Usa el siguiente alcance para la API de Local Services:

    https://www.googleapis.com/auth/adwords

    Este es el mismo permiso de OAuth 2.0 que usa la API de Google Ads.

    Al final de este paso, recibirás dos tokens: uno de actualización y uno de acceso. Guarda ambos.

  3. Ejecuta el siguiente comando en un símbolo del sistema para verificar que el paso anterior se haya realizado correctamente:

    curl https://oauth2.googleapis.com/tokeninfo?access_token=<INSERT_ACCESS_TOKEN>

    Si el resultado del comando muestra un mensaje como el siguiente, significa que se ejecutó correctamente:

    {
  "azp": "************-********************************.apps.googleusercontent.com",
  "aud": "************-********************************.apps.googleusercontent.com",
  "scope": "https://www.googleapis.com/auth/adwords [googleapis.com]",
  "exp": "1611183382",
  "expires_in": "3482",
  "access_type": "offline"
}

    Si hay un error o el alcance no es correcto, intenta generar los tokens de nuevo.

  4. Genera un token de acceso nuevo sin intervención manual. Esto es importante porque los tokens de acceso vencen cada hora. Los tokens de actualización tardan mucho más en vencer, por lo que, a menudo, debes revocarlos manualmente cuando ya no los necesites.

    Para obtener un token de acceso nuevo, ejecuta el siguiente comando:

    curl --data "refresh_token=<INSERT_REFRESH_TOKEN>&client_id=<INSERT_CLIENT_ID>&client_secret=<INSERT_CLIENT_SECRET>&grant_type=refresh_token" -X POST "https://oauth2.googleapis.com/token”

  5. Ejecuta la siguiente llamada a la API:

    curl -H "Authorization: Bearer <INSERT_ACCESS_TOKEN>" https://localservices.googleapis.com/v1/accountReports:search?query=manager_customer_id:<INSERT_10_DIGIT_MANAGER_CUSTOMER_ID_WITHOUT_HYPHENS>

    Si esta llamada se realiza correctamente, significa que se completó la configuración.