Guía práctica

En esta página, se proporcionan detalles sobre cómo realizar tareas comunes con la API.

Cómo crear usuarios

UserService permite un usuario con derechos de administrador para crear un usuario directamente en su red. Cualquier desarrollador puede hacer esto sin que el usuario nuevo se registre primero. Por ejemplo, si estás probando la API para por primera vez, en lugar de realizar todas las llamadas a la API como administrador (el para tu dirección de correo electrónico), puedes crear algunos usuarios con roles como Vendedor, coordinador de anuncios o anunciante para probar flujos de trabajo del mundo real

  1. Crea algunas direcciones de Gmail nuevas, como my.name.salesperson@gmail.com. Por otro lado, registrar una dirección existente que no es de Gmail como una nueva Cuenta de Google
  2. Llama a createUsers con la dirección nueva y el Role elegido.
  3. Puedes autenticarte como ese usuario nuevo, utilizando OAuth 2.0 para generar tu token de acceso.

Cómo obtener la AdUnit raíz

Tanto la AdUnit de nivel superior a la que puedes agregar nodos secundarios, como la profundidad permitida de la jerarquía, dependen de tu tipo de cuenta (pequeña empresa o premium). El AdUnit de nivel superior que admite la modificación de sus nodos secundarios se denomina AdUnit de raíz vigente.

Para recuperar la raíz efectiva, llama a NetworkService.getCurrentNetwork() y examina el campo effectiveRootAdUnitId en el objeto Network que se muestra.

Nota: Los diferentes tipos de cuentas admiten distintos patrones jerárquicos.

Consulta un objeto

Buscas objetos por criterios de búsqueda con el método getObjectsByStatement(). que muchos servicios exponen, y Object es un tipo de objeto específico. Esta toma una consulta de PQL, que es similar a una consulta de SQL, ya que te permite especificar campos para buscar (donde los nombres de campos se asignan a propiedades en el objeto), ordenar, limitar y compensar los resultados de la búsqueda. Consulta el PQL Guía para aprender más sobre PQL y aprender qué campos de objetos puedes filtrar por

Cómo crear un pedido

Para crear un pedido, simplemente crea un objeto Order y configura el anunciante. los IDs del vendedor y de los coordinadores de anuncios a los usuarios correspondientes, asignarles y llama a createOrders(). El resultado incluirá la Order recién creada, o un error.

Ejemplo

Consulta un ejemplo de código Java para crear un pedido.

Cómo crear una línea de pedido

Estos son los pasos para crear una nueva línea de pedido:

  1. Crea un objeto Order nuevo o usa uno existente.
  2. Crea un nuevo objeto LineItem y establece el tipo de rotación, el array del tamaño de las creatividades. las fechas de inicio y finalización y otras propiedades.
  3. Crea un nuevo objeto InventoryTargeting y especifica a qué objetos Placement o AdUnit deseas orientar o excluir.
  4. Une tu objeto InventoryTargeting dentro de un objeto Targeting nuevo y asigna a la propiedad de segmentación de tu LineItem.
  5. Llama al método del servicio de línea de pedido createLineItems() con tu objeto nuevo y examina el resultado para ver si se creó el objeto.

Ejemplo

Consulta el código Java para crear una línea de pedido de ejemplo.

Cómo crear una creatividad

Los distintos tipos de creatividades admiten distintos componentes; por ejemplo, una imagen. La creatividad admite un solo archivo fuente para la imagen. una creatividad Flash admite Dos archivos de elementos subyacentes: un archivo flash y un archivo de imagen de copia de seguridad, en caso de que lo hagamos. no se puede entregar el archivo. En el caso de las creatividades alojadas en sitios de terceros, deberás subir Solo un fragmento de HTML que haga referencia al archivo en el servidor de terceros. Consulta tu subclase específica de Creative para saber qué elementos tendrás que subir en orden para crear tu creatividad.

Ejemplo

Consulta el ejemplo de código Java para crear una creatividad de imagen.

Cómo modificar un objeto existente

Para modificar un objeto existente, llama a getObjectsByStatement() para buscar tu objeto. actualiza los valores de los objetos que se muestran y, luego, llama a updateObjects().

Nota: Los objetos actualizados reemplazarán a los existentes por completo, por lo que no configures un valor de propiedad en el objeto que envíes, el objeto guardado para obtener el valor predeterminado de esa propiedad, no el valor anterior.

Cambia el estado del objeto

El estado del objeto se cambia mediante una llamada al método performObjectAction() que expone tu servicio. Este método tiene dos parámetros:

  • Una instancia del objeto de acción que describe lo que quieres hacer. Para el servicio de pedidos expone varias acciones, como ApproveOrders, PauseOrders, y ArchiveOrders. Todos los objetos de acción derivan de una acción base clase adecuada para tu servicio.
  • Una consulta de PQL que describe qué objetos cambiar. Puedes cambiar el estado de uno o más objetos a la vez mediante la especificación de un PQL adecuado declaración.

Cómo generar etiquetas de anuncios

No puedes generar etiquetas de anuncios con la API. debes usar el sitio web de Google Ad Manager. Consulte el Centro de etiquetas en la sección del Centro de ayuda para más información.

Más ejemplos

Puedes encontrar muchos más ejemplos en el código de muestra de nuestra biblioteca cliente, en varias diferentes lenguajes de programación. Consulta la documentación de Biblioteca cliente y Código de ejemplo para obtener un vínculo con ejemplos en tu lenguaje de programación.