Antecedentes

Antes de comenzar

  1. Pídele a tu representante de cuenta que configure los permisos adecuados para las cuentas a las que accederá tu aplicación.
  2. Si desconoces los conceptos de Authorized Buyers, visita el Centro de ayuda de Authorized Buyers y experimenta con la interfaz de usuario. Si se espera que tu aplicación realice ofertas en tiempo real, lee el Protocolo RTB.
  3. Visita el Consola de APIs para configurar un nuevo proyecto. Accede a tu Cuenta de Google de desarrollador o crear una cuenta. A continuación, se te pedirá que crees un proyecto y lo apruebes. con algunas Condiciones del Servicio.

Cuentas principales y secundarias

Si trabajas dentro de una estructura de cuenta que incluye elementos superiores y secundarios puedes trabajar con más eficacia si entiendes cómo interactúan. A continuación, se incluye un breve resumen:

Cuentas secundarias

Un usuario con credenciales que otorgan acceso a una cuenta secundaria solo puede ver y modificar los recursos asociados con su cuenta. Las cuentas secundarias no pueden Ver o modificar recursos que pertenecen a otras cuentas principales o secundarias

Cuentas principales

Puede ver un usuario con credenciales que otorgan acceso a una cuenta parental. y modificar los recursos de la cuenta principal, además de todos los recursos cuentas secundarias. Para las operaciones que enumeran todo un recurso determinado, este usuario recibirán una respuesta que incluye los datos de su cuenta y todos sus cuentas secundarias. Para otros tipos de solicitudes dirigidas a recursos de licencias secundarias, La cuenta principal deberá especificar un parámetro de ruta de acceso accountId para el secundario en lugar de su propia accountId.

El modelo de datos de la API de REST

Un recurso es una entidad de datos individual con un identificador único. El El recurso de cuentas representa una entrada de cuenta de Authorized Buyers y es la raíz clase de datos para la API de Ad Exchange Buyer. Los métodos de la API operan en clústeres individuales recursos accounts y en colecciones de recursos Accounts.

La opción Cuentas Un recurso incluye un ID de cuenta, la información que se usa en la coincidencia de cookies, ubicaciones de los ofertantes, la URL a la que se envían las solicitudes de ofertas y una solicitud para especificar la cantidad máxima de consultas por segundo que enviará el intercambio de anuncios.

Además del recurso Cuentas, la API de Ad Exchange Buyer define las siguientes estructuras de datos:

Ubicación del ofertante

Las ubicaciones de los ofertantes son estructuras que se muestran con los recursos de Cuentas. para proporcionar la URL a la que Ad Exchange debe enviar las solicitudes de oferta Es la cantidad máxima de consultas por segundo que Ad Exchange debería enviar. Este es un Ejemplo de la ubicación de un ofertante, expresado en JSON:

"bidderLocation": [
    {
      "url": "http://bid.url.com/bidder",
      "maximumQps": 1500
    }
  ],

Elementos

Los elementos proporcionan una lista de cuentas. Este es un ejemplo de los elementos, expresados en JSON:

{
  "kind": "adexchangebuyer#accountsList",
  "items": [
    accounts Resource
  ]
}

Operaciones admitidas

Puedes invocar tres métodos diferentes en las colecciones y los recursos en la API de Ad Exchange Buyer, como se describe en la siguiente tabla. Todas las operaciones requieren autorización.

Operación Descripción Asignaciones de HTTP de REST
list Enumera todas las cuentas a las que puede acceder la cuenta autenticada actualmente. usuario. GET en un URI de colección
get Obtiene un recurso Accounts específico. GET en un URI de recurso
actualización Actualiza un recurso Accounts específico. PUT en un URI de recurso, donde pasas datos para el recurso actualizado.

Estilo de la llamada

REST es un estilo de arquitectura de software que proporciona un enfoque conveniente y coherente para solicitar y modificar datos.

El término REST es la abreviatura de "Representational State Transfer" (transferencia de estado representacional). En el contexto de las API de Google, se refiere al uso de los verbos HTTP para recuperar y modificar las representaciones de los datos almacenados por Google.

En un sistema RESTful, los recursos se almacenan en un almacén de datos; un cliente envía una solicitud para que el servidor ejecute una acción en particular (como crear, recuperar, actualizar o borrar un recurso) y el servidor ejecuta la acción y envía una respuesta que, por lo general, es una representación del recurso especificado.

En las API con tecnología REST de Google, el cliente especifica una acción con un verbo HTTP como POST, GET, PUTDELETE. Especifica un recurso mediante un URI único a nivel global de la siguiente manera:

https://www.googleapis.com/apiName/apiVersion/resourcePath?parameters

Dado que todos los recursos de API tienen URI únicos accesibles a través de HTTP, REST permite el almacenamiento de datos en caché y está optimizado para funcionar con la infraestructura distribuida de la Web.

Puedes encontrar las definiciones de métodos en la documentación de estándares del HTTP 1.1, los que incluyen especificaciones para GET, POST, PUT y DELETE.

REST en la API de Ad Exchange Buyer

Las operaciones admitidas se asignan directamente a los verbos HTTP de REST, como se describe en Operaciones de API.

El formato específico para los URIs de API es el siguiente:

https://www.googleapis.com/adexchangebuyer/v1.4/resourceID?parameters

donde resourceID es el identificador de un recurso de cuentas y parameters son cualquier parámetros para aplicar a la consulta. Consulta parámetros de consulta estándar y las documentación de referencia para conocer los detalles.

El formato de las extensiones de ruta de acceso resourceID te permite identificar el recurso en el que estás trabajando actualmente, por ejemplo:

https://www.googleapis.com/adexchangebuyer/v1.4/accounts
https://www.googleapis.com/adexchangebuyer/v1.4/accounts/id

El conjunto completo de URI que se usa para cada operación compatible en la API se se resumen en el documentación de referencia.

A continuación, se muestra un ejemplo de cómo funciona esto en la API de Ad Exchange Buyer.

Obtén la lista de cuentas del usuario autenticado:

GET https://www.googleapis.com/adexchangebuyer/v1.4/accounts

Formato de los datos

JSON

JSON (JavaScript Object Notation) es un formato de datos común y, también, independiente del lenguaje que proporciona una representación de texto simple de estructuras de datos arbitrarias. Para obtener más información, visita json.org.