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

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

مراجع

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

للإبلاغ عن مشاكل والعثور على دعم آخر، يُرجى الاطّلاع على دليل دعم "مساحة العرض والفيديو 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);
  }
}