> ## Documentation Index
> Fetch the complete documentation index at: https://generaltranslation.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Acceso a cuentas de anuncios

<div id="user-accounts-vs-ad-accounts">
  # Cuentas de usuario vs cuentas publicitarias
</div>

Hay dos tipos diferentes de cuentas involucradas en el uso de Ads API: cuentas publicitarias y cuentas de usuario de X. A lo largo de la documentación de Ads API, el término «account» generalmente se refiere a la cuenta publicitaria.

* Las cuentas publicitarias se registran en **business.x.com** y se identifican en la API mediante account\_id. Las cuentas publicitarias se vinculan directamente a fuentes de financiamiento y utilizan contenido de una o más cuentas de usuario de X como «promotable users». Cada cuenta publicitaria puede otorgar permiso a una o más cuentas de usuario de X. La cuenta publicitaria, o «current account», está representada en casi todas las URL que se ejecutan como un parámetro en línea :account\_id.
* Las cuentas de usuario de X (como @AdsAPI) se identifican por user\_id en Ads API. Una o más de estas cuentas se pueden asociar con una cuenta publicitaria. La cuenta de usuario de X autenticada que realiza solicitudes en la API se denomina «current user». Se puede encontrar un listado de las cuentas publicitarias a las que el current user tiene acceso con [GET accounts](/es/x-ads-api/campaign-management#accounts). «Promotable users» son handles de X que pueden ser promocionados por una cuenta publicitaria específica. Para más detalles sobre esto, consulta [Obtaining Ads Account Access](/es/x-ads-api/introduction).

<div id="methods-for-ad-account-access">
  ## Métodos para acceder a una cuenta de anuncios
</div>

Hay dos métodos que puedes usar para hacer solicitudes a la Ads API para la cuenta de un anunciante:

1. Hacer solicitudes en nombre de un anunciante (**recomendado**)
2. Hacer solicitudes usando tu cuenta, a la que se le ha otorgado acceso a la cuenta de un anunciante, por ejemplo, una [Agency](https://business.x.com/en/blog/agencies-manage-multiple-Twitter-Ads-accounts.html) que administra varias cuentas.

Este documento es una breve descripción general de las diferencias entre estas opciones y debe utilizarse junto con nuestros otros recursos, como las [preguntas frecuentes sobre inicio de sesión multiusuario](https://business.x.com/en/help/troubleshooting/multi-user-login-faq.html). 

Como se describe en [Autorizar una solicitud](/es/resources/fundamentals/authentication#authorizing-a-request#authorizing-a-request), todas las solicitudes a la Ads API requieren encabezados de autorización que usen [OAuth 1.0a](/es/resources/fundamentals/authentication) con un token de acceso obtenido mediante el flujo [OAuth](/es/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow) de [3-legged](/es/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow). Tu aplicación tendrá que implementar un flujo OAuth basado en la web para [obtener tokens de acceso](/es/resources/fundamentals/authentication#oauth-1-0a-2). Los desarrolladores de la Ads API nunca deben pedir a nuestros anunciantes de X que compartan sus credenciales de inicio de sesión.

De forma predeterminada, cada [aplicación de desarrollador de X](/es/resources/fundamentals/developer-apps) contiene un **token de acceso** estático que se puede usar para hacer solicitudes a la Ads API para la cuenta que es propietaria de la aplicación. Estas credenciales son ideales para casos de uso de una sola cuenta sin requerir un flujo OAuth de 3-legged o basado en [PIN](/es/resources/fundamentals/authentication#pin-based-authorization). Si no necesitas acceder a otra X Ads Account, usa estas credenciales de [un solo usuario](/es/resources/fundamentals/authentication#oauth-1-0a-2) en lugar de los pasos siguientes.

<div id="levels-of-access">
  ## Niveles de acceso
</div>

<div id="app-level-permissions">
  ### Permisos a nivel de App
</div>

Cada usuario tendrá un nivel de acceso según lo solicitado en la [solicitud de acceso a la Ads API](/es/x-ads-api/getting-started/step-by-step-guide):

* **Solo conversiones**: El usuario tiene acceso a los endpoints de [Mobile](/es/x-ads-api/measurement/mobile-conversions) y [Web Conversion](/es/x-ads-api/measurement/web-conversions) con acceso de [lectura y escritura](/es/resources/fundamentals/developer-apps).
* **Acceso estándar**: El usuario tiene acceso a los endpoints de [Analytics](/es/x-ads-api/analytics), [Campaign Management](https://developer.x.com/en/docs/twitter-ads-api/campaign-management/overview), [Creatives](https://developer.x.com/en/docs/twitter-ads-api/creatives/overview), [Custom Audiences](https://developer.x.com/en/docs/twitter-ads-api/audiences/overview) y [Conversion](/es/x-ads-api/measurement/web-conversions) con acceso de [lectura y escritura](/es/resources/fundamentals/developer-apps).

**Nota:** Los desarrolladores de la Ads API que solicitaron acceso antes de julio de 2023 pueden tener diferentes niveles de acceso y permisos, y pueden estar limitados a cinco tokens OAuth. Consulta nuestra guía sobre [cómo aumentar el acceso](/es/x-ads-api/getting-started/increasing-access) para acceder a endpoints adicionales o eliminar los límites de tokens para aplicaciones existentes.

<div id="ad-account-level-permissions">
  ### Permisos a nivel de cuenta de anuncios
</div>

Cada usuario que tenga acceso a una cuenta de anuncios tendrá un permiso específico a nivel de cuenta: **Administrador de cuenta**, **Administrador de anuncios**, **Analista de campañas**, **Analista orgánico** y **Administrador creativo**; consulta **business.x.com** para ver la documentación más reciente sobre permisos a nivel de cuenta. Las aplicaciones deben obtener los permisos del usuario actualmente autenticado mediante el endpoint de la API [Authenticated User Access](/es/x-ads-api/campaign-management#authenticated-user-access) para determinar a qué endpoints de la API y a qué funciones de Ads pueden acceder.

**Nota:** Cualquier token de usuario utilizado con la [Conversion API](/es/x-ads-api/measurement/web-conversions) debe corresponder a usuarios con permisos a nivel de cuenta de **Administrador de cuenta** o **Administrador de anuncios**.                                                                                                                                              

<div id="methods-of-obtaining-access-tokens">
  ## Métodos para obtener tokens de acceso
</div>

<div id="1-obtain-an-advertisers-user-access-token">
  ### 1. Obtén el token de acceso (de usuario) de un anunciante
</div>

Hay dos métodos para obtener el **token de acceso** de un anunciante. El método más común es mediante un [flujo OAuth de 3 partes](/es/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow) directamente desde tu interfaz web. Las aplicaciones que no tienen una interfaz pública accesible para anunciantes pueden implementar un proceso OAuth [basado en PIN](/es/resources/fundamentals/authentication#pin-based-authorization). Después de que el usuario complete el flujo de 3 partes, tu aplicación tendrá credenciales para hacer solicitudes a su cuenta de Ads mediante la API.

Obtener credenciales de usuario mediante un flujo OAuth es el método que **recomendamos encarecidamente** para que la mayoría de los desarrolladores de la Ads API obtengan acceso a una cuenta de anunciante. Te permite llamar a la API en nombre de un usuario y realizar acciones en su representación. Estos tokens no caducan, pero el usuario puede revocarlos en cualquier momento.

<div id="2-obtain-your-developer-access-token">
  ### 2. Obtén tu token de acceso (de Desarrollador)
</div>

Esta opción requiere que el anunciante [conceda acceso a tu @username](https://business.x.com/en/help/troubleshooting/multi-user-login-faq.html) (o @usernames) a su cuenta de X Ads mediante la interfaz de X en business.x.com. Los **tokens de acceso** obtenidos mediante el flujo OAuth de tres patas (3-legged OAuth) para tu cuenta podrán acceder a la cuenta de X Ads del anunciante.

Esto te permite llamar a la API usando los tokens OAuth de tu propio @username en lugar de los tokens OAuth del anunciante. La diferencia clave en esta opción es que solo podrás crear Publicaciones solo promocionadas (Promoted-Only Posts) si se ha otorgado a tu @username el permiso de delegación/creación de Publicaciones.

Para obtener acceso para crear Publicaciones solo promocionadas en nombre del usuario promocionable `FULL` de la cuenta, también se te debe otorgar acceso para crear Publicaciones en este flujo. Esto habilitará el acceso mediante el permiso `TWEET_COMPOSER` en el endpoint [GET accounts/:account\_id/authenticated\_user\_access](/es/x-ads-api/campaign-management#accounts).

<div id="differences-between-these-methods">
  ## Diferencias entre estos métodos
</div>

|                                                                                           |                                     |                                                                                 |
| :---------------------------------------------------------------------------------------- | :---------------------------------- | :------------------------------------------------------------------------------ |
|                                                                                           | Token OAuth de anunciante (usuario) | Token OAuth (desarrollador)  <br /> (@username agregado para separar la cuenta) |
| Acceder a la cuenta de X Ads                                                              | ✔                                   | ✔                                                                               |
| Crear Publicaciones en nombre del usuario                                                 | ✔                                   | ✔\*                                                                             |
| Gestionar campañas                                                                        | ✔                                   | ✔                                                                               |
| Acceder a Analytics                                                                       | ✔                                   | ✔                                                                               |
| Crear Cards en nombre del usuario                                                         | ✔                                   | ✔                                                                               |
| Capacidad del desarrollador de acceder  <br />a través de la interfaz de usuario de X Ads |                                     | ✔                                                                               |
| [Límites de tasa](/es/x-api/enterprise-gnip-2.0/fundamentals/rate-limits)                 | Específicos por anunciante          | Específicos por cuenta de anunciante                                            |

<Note>
  **Nota:** Consulta la sección **[Obtén tu token de acceso (desarrollador)](/es/x-ads-api/fundamentals/accessing-ads-accounts#2-obtain-your-developer-access-token)** anterior para más detalles.
</Note>

<div id="sample-use-case">
  ## Ejemplo de caso de uso
</div>

<div id="advertisers-access-token-via-oauth-3-legged-web-flow">
  ### Token de acceso del anunciante mediante el flujo web OAuth de 3 patas
</div>

El flujo estándar es un flujo web y usa el flujo OAuth de [autorización de 3 patas](/es/resources/fundamentals/authentication#obtaining-access-tokens-using-3-legged-oauth-flow). Las capturas de pantalla que se describen aquí forman parte de un ejemplo cuyo código fuente puedes ver en [https://github.com/xdevplatform/twauth-web](https://github.com/xdevplatform/twauth-web).

En algún punto de tu aplicación, querrás redirigir a X para autorizar tu aplicación.

<Frame>
  <img src="https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/images/twauth-web-2.png" alt="image0" />
</Frame>

Cuando rediriges a X con el token de solicitud, se le pedirá al usuario que autorice tu aplicación.

<Frame>
  <img src="https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/images/twauth-web-3.png" alt="image1" />
</Frame>

Al autorizar tu aplicación, el usuario será redirigido a la URL de callback que proporcionaste cuando generaste el token de solicitud. La utilizarás para obtener el token de acceso permanente para este usuario y almacenarlo localmente.

<Frame>
  <img src="https://cdn.cms-twdigitalassets.com/content/dam/developer-twitter/images/twauth-web-4.png" alt="image" />
</Frame>
