خدمة "مساحة العرض والفيديو 360"

باستخدام خدمة Apps Script المتقدّمة في "مساحة العرض والفيديو 360"

تتيح لك خدمة "مساحة العرض والفيديو 360"‏ (DV360) استخدام DV360 API في Google Apps Script. توفّر واجهة برمجة التطبيقات هذه إمكانية الوصول الآلي إلى Display & Video API.

هذه خدمة متقدّمة يجب تفعيلها قبل الاستخدام.

مراجع

للحصول على معلومات تفصيلية عن هذه الخدمة، يُرجى الاطّلاع على المستندات المرجعية الخاصة بـ DV360 API. مثل جميع الخدمات المتقدّمة في Apps Script، تستخدم خدمة DV360 العناصر والطرق والمعلَمات نفسها التي تستخدمها واجهة برمجة التطبيقات العامة. لمزيد من المعلومات، اطّلِع على كيفية تحديد التواقيع.

للإبلاغ عن المشاكل والعثور على دعم آخر، يُرجى الاطّلاع على دليل دعم "مساحة العرض والفيديو 360".

نموذج التعليمات البرمجية

يستخدم نموذج الرمز التالي الإصدار 4 من واجهة برمجة التطبيقات.

الحصول على قائمة بالشركاء

يسجّل هذا النموذج جميع الشركاء المتاحين في الحساب.

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

الحصول على قائمة بالحملات النشطة

تسجّل هذه العيّنة أسماء وأرقام تعريف جميع الحملات النشطة. يُرجى العِلم أنّه يتم استخدام رموز مميّزة خاصة بتقسيم المحتوى إلى صفحات لاسترداد القائمة بأكملها.

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

تعديل الاسم المعروض لـ "تفاصيل الإعلان"

يعدّل هذا النموذج الاسم المعروض لبند إعلاني.

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