Display & Video 360 Hizmeti

Apps Komut Dosyası Display & Video 360 gelişmiş hizmetini kullanarak

Display & Video 360 (DV360) hizmeti, Google Apps Script'te DV360 API'yi kullanmanıza olanak tanır. Bu API, Display & Video API'ye programatik erişim sağlar.

Bu, kullanımdan önce etkinleştirilmesi gereken gelişmiş bir hizmettir.

Referans

Bu hizmetle ilgili ayrıntılı bilgi için DV360 API'nin referans belgelerine bakın. Apps Komut Dosyası'ndaki tüm gelişmiş hizmetler gibi, DV360 hizmeti de herkese açık API ile aynı nesneleri, yöntemleri ve parametreleri kullanır. Daha fazla bilgi için Yöntem imzalarının nasıl belirlendiği başlıklı makaleyi inceleyin.

Sorunları bildirmek ve diğer destek seçeneklerini görmek için DV360 Destek Kılavuzu'na bakın.

Örnek kod

Aşağıdaki örnek kodda API'nin 4. sürümü kullanılmaktadır.

İş ortaklarının listesini alma

Bu örnek, hesaptaki tüm iş ortaklarını günlüğe kaydeder.

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

Etkin kampanyaların listesini alma

Bu örnek, etkin tüm kampanyaların adlarını ve kimliklerini kaydeder. Listenin tamamını almak için sayfalama jetonlarının kullanıldığını unutmayın.

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

Satır öğesinin görünen adını güncelleme

Bu örnek, bir satır öğesinin görünen adını günceller.

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