השירות Display & Video 360

באמצעות השירות המתקדם של Display & Video 360 ב-Apps Script.

שירות Display & Video 360‏ (DV360) מאפשר לכם להשתמש ב-DV360 API ב-Google Apps Script. ממשק ה-API הזה מספק גישה פרוגרמטית ל-Display & Video API.

זהו שירות מתקדם שצריך להפעיל לפני השימוש.

חומרי עזר

מידע מפורט על השירות הזה מופיע במאמרי העזרה של DV360 API. בדומה לכל השירותים המתקדמים ב-Apps Script, שירות DV360 משתמש באותם אובייקטים, שיטות ופרמטרים כמו ה-API הציבורי. מידע נוסף זמין במאמר איך נקבעות חתימות של שיטות.

כדי לדווח על בעיות ולמצוא אפשרויות תמיכה אחרות, אפשר לעיין במדריך התמיכה של DV360.

קוד לדוגמה

בדוגמת הקוד הבאה נעשה שימוש בגרסה 4 של ה-API.

קבלת רשימה של שותפים

בדוגמה הזו מתועדים כל השותפים שזמינים בחשבון.

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