نمایش & سرویس Video 360

سرویس Display & Video 360 (DV360) به شما امکان می‌دهد از API DV360 در Apps Script استفاده کنید. این API دسترسی برنامه‌نویسی‌شده به Display & Video API را فراهم می‌کند.

مرجع

برای اطلاعات دقیق در مورد این سرویس، به مستندات مرجع API مربوط به DV360 مراجعه کنید. مانند تمام سرویس‌های پیشرفته در Apps Script، سرویس DV360 از همان اشیاء، روش‌ها و پارامترهای API عمومی استفاده می‌کند. برای اطلاعات بیشتر، به بخش «نحوه تعیین امضاهای روش» مراجعه کنید.

برای گزارش مشکلات و یافتن پشتیبانی‌های دیگر، به راهنمای پشتیبانی DV360 مراجعه کنید.

کد نمونه

کد نمونه زیر از نسخه ۴ این API استفاده می‌کند.

دریافت لیست شرکا

این نمونه، تمام شرکای موجود در حساب را ثبت می‌کند.

پیشرفته/نمایشگر.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);
  }
}

دریافت لیست کمپین‌های فعال

این نمونه، نام‌ها و شناسه‌های (ID) تمام کمپین‌های فعال را ثبت می‌کند. به استفاده از توکن‌های صفحه‌بندی برای بازیابی کل لیست توجه کنید.

پیشرفته/نمایشگر.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);
  }
}

نام نمایشی یک آیتم خطی را به‌روزرسانی می‌کند

این نمونه نام نمایشی یک آیتم خطی را به‌روزرسانی می‌کند

پیشرفته/نمایشگر.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);
  }
}