Servicio de Display & Video 360

El servicio de Display & Video 360 (DV360) te permite usar la API de DV360 en Apps Script. Esta API proporciona acceso programático a la API de Display & Video.

Referencia

Para obtener información detallada sobre este servicio, consulta la documentación de referencia de la API de DV360. Al igual que todos los servicios avanzados de Apps Script, el servicio de DV360 usa los mismos objetos, métodos y parámetros que la API pública. Para obtener más información, consulta Cómo se determinan las firmas de métodos.

Para informar problemas y encontrar otro tipo de asistencia, consulta la guía de asistencia de DV360.

Código de muestra

En el siguiente código de ejemplo, se usa la versión 4 de la API.

Obtén una lista de socios

En este ejemplo, se registran todos los socios disponibles en la cuenta.

advanced/displayvideo.gs
/**
 * Logs all of the partners available in the account.
 */
function listPartners() {
  // Retrieve the list of available partners
  try {
    const partners = DisplayVideo.Partners.list();

    if (partners.partners) {
      // Print out the ID and name of each
      for (let i = 0; i < partners.partners.length; i++) {
        const partner = partners.partners[i];
        console.log('Found partner with ID %s and name "%s".',
            partner.partnerId, partner.displayName);
      }
    }
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);
  }
}

Obtén una lista de las campañas activas

En este ejemplo, se registran los nombres y los IDs de todas las campañas activas. Ten en cuenta el uso de tokens de paginación para recuperar la lista completa.

advanced/displayvideo.gs
/**
 * Logs names and ID's of all active campaigns.
 * Note the use of paging tokens to retrieve the whole list.
 */
function listActiveCampaigns() {
  const advertiserId = '1234567'; // Replace with your advertiser ID.
  let result;
  let pageToken;
  try {
    do {
      result = DisplayVideo.Advertisers.Campaigns.list(advertiserId, {
        'filter': 'entityStatus="ENTITY_STATUS_ACTIVE"',
        'pageToken': pageToken
      });
      if (result.campaigns) {
        for (let i = 0; i < result.campaigns.length; i++) {
          const campaign = result.campaigns[i];
          console.log('Found campaign with ID %s and name "%s".',
              campaign.campaignId, campaign.displayName);
        }
      }
      pageToken = result.nextPageToken;
    } while (pageToken);
  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);
  }
}

Actualiza el nombre visible de un concepto

En este ejemplo, se actualiza el nombre visible de una línea de pedido

advanced/displayvideo.gs
/**
 * Updates the display name of a line item
 */
function updateLineItemName() {
  const advertiserId = '1234567'; // Replace with your advertiser ID.
  const lineItemId = '123456789'; //Replace with your line item ID.
  const updateMask = "displayName";

  const lineItemDef = {displayName: 'New Line Item Name (updated from Apps Script!)'};

  try {
    const lineItem = DisplayVideo.Advertisers.LineItems
        .patch(lineItemDef, advertiserId, lineItemId, {updateMask:updateMask});


  } catch (e) {
    // TODO (Developer) - Handle exception
    console.log('Failed with error: %s', e.error);
  }
}