Servicio de Display & Video 360

Cómo usar el servicio avanzado de Display &Video 360 de Apps Script.

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

Este es un servicio avanzado que se debe habilitar antes de usarlo.

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 otra asistencia, consulta la guía de asistencia de DV360.

Código de muestra

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

Cómo obtener una lista de socios

En esta muestra, 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);
  }
}

Cómo obtener una lista de campañas activas

En esta muestra, 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);
  }
}

Cómo actualizar el nombre visible de un elemento de línea

En esta muestra, se actualiza el nombre visible de un elemento de línea.

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);
  }
}