Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
Todas las llamadas a la API de Google Ad Manager deben autorizarse a través de OAuth2, un estándar abierto que
permite a los usuarios otorgar permisos a aplicaciones de terceros, por lo que
aplicación puede interactuar con los servicios web en nombre del usuario. OAuth2 permite
tu aplicación cliente de la API de Ad Manager para acceder a la cuenta de Ad Manager de un usuario
sin tener que administrar ni almacenar
el nombre de usuario ni la contraseña.
Genera credenciales de OAuth2
Realiza los siguientes pasos para generar las credenciales de OAuth2.
1. Cómo determinar el tipo de autenticación
Consulta la siguiente tabla para ver qué tipo de autenticación es el más adecuado.
para tu aplicación con la API de Ad Manager:
Elige tu tipo de autenticación de OAuth2
Cuenta de servicio
Elige esta opción si solo necesitas acceso a tus propios datos de Ad Manager.
Una vez que hayas determinado el tipo de autenticación, haz clic en la pestaña correspondiente.
y sigue las instrucciones para generar las credenciales de OAuth2:
En el menú desplegable de proyectos, selecciona Create a new project y, luego, ingresa un nombre.
para el proyecto y, de forma opcional, edita el ID del proyecto proporcionado. Haz clic en
Crear.
En la página Credenciales, selecciona Crear credenciales y, luego,
Selecciona Clave de cuenta de servicio.
En el menú desplegable de proyectos, selecciona Create a new project y, luego, ingresa un nombre.
para el proyecto (y, de manera opcional, edita el ID del proyecto proporcionado) y haz clic en
Crear.
En la página Credenciales, selecciona Crear credenciales y, luego,
Selecciona ID de cliente de OAuth.
Es posible que se te solicite ingresar un nombre de producto en la
página Pantalla de consentimiento Si es así, haz clic en Configurar pantalla de consentimiento.
proporcione la información solicitada y haga clic en Guardar para regresar a
Página de credenciales
En Tipo de aplicación, selecciona Aplicación web. Sigue el
instrucciones para ingresar orígenes JavaScript, URIs de redireccionamiento o ambos.
Haz clic en Crear.
En la página que aparece, copia el ID de cliente y el secreto del cliente.
en el portapapeles, ya que los necesitarás cuando configures el cliente
biblioteca.
3. Configura tu red de Ad Manager
Si eres un desarrollador externo, es posible que debas pedirle al cliente que haga esto.
paso a paso por ti.
Asegúrate de que el acceso a la API esté habilitado.
Haz clic en el botón Agregar un usuario de cuenta de servicio.
Completa el formulario con el correo electrónico de la cuenta de servicio. El
usuario de la cuenta de servicio debe tener permisos para acceder a la
como si ese usuario de la cuenta de servicio accediera a las entidades de
la IU.
Haz clic en el botón Guardar. Debería aparecer un mensaje que confirme
la adición de tu cuenta de servicio.
Para ver los usuarios existentes de la cuenta de servicio, vaya a la pestaña Usuarios y, luego,
haciendo clic en el filtro Cuenta de servicio.
Nuestras bibliotecas cliente se encargan
automáticamente de los detalles que se indican a continuación
Continúa leyendo si te interesa lo que sucede detrás de escena.
Esta sección está dirigida a usuarios avanzados que ya conocen
con la especificación OAuth2 y
Aprende a usar OAuth2 con las APIs de Google.
Encabezado de la solicitud HTTP
El encabezado HTTP en cada solicitud a la API de Ad Manager debe incluir un acceso
token de la siguiente forma:
Un solo token de acceso puede otorgar diversos grados de acceso a múltiples APIs. R
variable llamada scope controla el conjunto de recursos y
las operaciones que permite un token de acceso. Durante la solicitud de token de acceso, tu
la aplicación envía uno o más valores en el parámetro scope.
Ad Manager tiene un solo alcance, que se muestra a continuación. Se debe realizar la autorización
a nivel del usuario dentro del producto.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-31 (UTC)"],[[["\u003cp\u003eAll Google Ad Manager API calls require OAuth2 authorization for secure access to user data without storing sensitive login information.\u003c/p\u003e\n"],["\u003cp\u003eChoose between Service Account or Web Application authentication type based on your application's needs.\u003c/p\u003e\n"],["\u003cp\u003eGenerate OAuth2 credentials by following instructions for your chosen authentication type via the Google API Console.\u003c/p\u003e\n"],["\u003cp\u003eConfigure your Ad Manager network settings and client library according to provided guidelines for the specific authentication method and programming language.\u003c/p\u003e\n"],["\u003cp\u003eClient libraries handle most OAuth2 complexities but you can delve into the background details concerning HTTP headers and scopes if needed.\u003c/p\u003e\n"]]],["Google Ad Manager API access requires OAuth2 authorization. First, choose between \"Service account\" for personal data or \"Web application\" for user-authorized access. Then, create OAuth2 credentials via the Google API Console, either generating a JSON key for service accounts or a client ID and secret for web applications. Next, configure the Ad Manager network to allow API access, adding the service account email if applicable. Lastly, configure and use a client library, or implement the OAuth2 flow directly, including the access token in the HTTP header.\n"],null,["# Authentication\n\nAll Google Ad Manager API calls must be authorized through [OAuth2](http://oauth.net/2/) an open standard that\nallows users to grant permissions to third-party applications, so the\napplication can interact with web services on the user's behalf. OAuth2 enables\nyour Ad Manager API client application to access a user's Ad Manager account\nwithout having to handle or store the user's username or password.\n\nGenerate OAuth2 credentials\n---------------------------\n\nPerform the following steps to generate the OAuth2 credentials.\n\n### 1. Determine your authentication type\n\nCheck the table below to see which **authentication type** is most appropriate\nfor your Ad Manager API application:\n\n| Choose your OAuth2 authentication type ||\n|---------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **Service account** | Choose this if you only need access to your own Ad Manager data. [Learn more.](/identity/protocols/OAuth2ServiceAccount) |\n| **Web application** | Choose this if you want to authenticate as any user who grants permission to your application to access their Ad Manager data. [Learn more.](/identity/protocols/OAuth2WebServer) |\n\n### 2. Create OAuth2 credentials\n\nOnce you've determined your authentication type, click the corresponding tab\nbelow and follow the instructions to generate the OAuth2 credentials:\nService Account\n\n1. Open the [Google API Console Credentials page](https://console.cloud.google.com/apis/credentials).\n2. From the project drop-down, choose **Create a new project** , enter a name for the project, and optionally, edit the provided Project ID. Click **Create**.\n3. On the Credentials page, select **Create credentials** , then select **Service account key**.\n4. Select [New service account](//console.developers.google.com/apis/credentials/serviceaccountkey), and select **JSON**.\n5. Click **Create** to download a file containing a private key.\nWeb application\n\n1. Open the [Google API Console Credentials page](https://console.cloud.google.com/apis/credentials).\n2. From the project drop-down, choose **Create a new project** , enter a name for the project (and optionally, edit the provided Project ID), and click **Create**.\n3. On the Credentials page, select **Create credentials** , then select **OAuth client ID**.\n4. You may be prompted to set a product name on the Consent Screen page; if so, click **Configure consent screen** , supply the requested information, and click **Save** to return to the Credentials page.\n5. Select **Web Application** for the **Application Type**. Follow the instructions to enter JavaScript origins, redirect URIs, or both.\n6. Click **Create**.\n7. On the page that appears, copy the **client ID** and **client secret** to your clipboard, as you will need them when you configure your client library.\n\n### 3. Configure your Ad Manager network\n\nIf you are a third-party developer, you may need to have your client do this\nstep for you.\nService Account\n\n1. Go to your [Ad Manager network](//admanager.google.com).\n2. Click the **Admin** tab.\n3. Ensure that **API access** is enabled.\n4. Click the **Add a service account user** button.\n5. Fill in the form using the service account email. The service account user must be granted with permissions to access the entities as if that service account user would access the entities on the UI.\n6. Click on the **Save** button. A message should appear, confirming the addition of your service account.\n7. View existing service account users by going to the Users tab and then clicking the **Service Account** filter.\nWeb application\n\n1. Go to your [Ad Manager network](//admanager.google.com).\n2. Click the **Admin** tab.\n3. Ensure that **API access** is enabled.\n\n### 4. Configure and use a client library\n\nFollow the appropriate guide below to use the credentials in your client library: \n\n### Java\n\n- [Service account flow](//github.com/googleads/googleads-java-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-java-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### .NET\n\n- [Service account flow](//github.com/googleads/googleads-dotnet-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-dotnet-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### Python\n\n- [Service account flow](//github.com/googleads/googleads-python-lib/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/googleads-python-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n### PHP\n\n- [Service account flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-using-own-credentials-(server-to-server-flow))\n- [Web app flow](https://github.com/googleads/googleads-php-lib/wiki/API-access-on-behalf-of-your-clients-(web-flow))\n\n### Ruby\n\n- [Service account flow](//github.com/googleads/google-api-ads-ruby/wiki/API-access-using-own-credentials-(server-to-server-flow)#step-2---setting-up-the-client-library)\n- [Web app flow](//github.com/googleads/google-api-ads-ruby/wiki/API-access-on-behalf-of-your-clients-(web-flow)#step-2---setting-up-the-client-library)\n\n\u003cbr /\u003e\n\nIf you choose not to use one of our client libraries, you'll need to implement\nthe OAuth2 [service account](/identity/protocols/OAuth2ServiceAccount) or [web\napp](/identity/protocols/OAuth2WebServer) flow yourself.\n\nBehind the scenes\n-----------------\n\nOur client libraries automatically take care of the details covered below so\nonly read on if you're interested in what's happening behind the scenes.\nThis section is intended for advanced users who are already familiar\nwith the [OAuth2 specification](http://tools.ietf.org/html/rfc6749) and\nknow how to [use OAuth2 with Google APIs](/accounts/docs/OAuth2).\n\n#### HTTP request header\n\nThe HTTP header in every request to the Ad Manager API must include an access\ntoken in this form: \n\n```actionscript-3\nAuthorization: Bearer ACCESS_TOKEN\n```\n\nFor example: \n\n```http\nPOST ... HTTP/1.1\nHost: ...\nAuthorization: Bearer 1/fFAGRNJru1FTz70BzhT3Zg\nContent-Type: text/xml;charset=UTF-8\nContent-Length: ...\n\n\u003c?xml version=\"1.0\"?\u003e\n\u003csoap:Envelope xmlns:soap=\"http://www.w3.org/2001/12/soap-envelope\"\u003e\n…\n\u003c/soap:Envelope\u003e\n```\n\n#### Scope\n\nA single access token can grant varying degrees of access to multiple APIs. A\nvariable parameter called `scope` controls the set of resources and\noperations that an access token permits. During the access token request, your\napplication sends one or more values in the `scope` parameter.\n\nAd Manager has only one scope, shown below. Authorization should be performed\nat the user level within the product.\n\n| Scope | Permissions |\n|---------------------------------------|-----------------------------------------------|\n| `https://www.googleapis.com/auth/dfp` | View and manage your campaigns on Ad Manager. |"]]
