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

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

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

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

مراجع

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

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

رمز نموذجي

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

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

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

advanced/displayvideo.gs

عرض على GitHub

/**
 * 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

عرض على GitHub

/**
 * 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

عرض على GitHub

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