บริการ Display & Video 360

โดยใช้บริการขั้นสูงของ Display &Video 360 ใน Apps Script

บริการ Display & Video 360 (DV360) ช่วยให้คุณใช้ DV360 API ใน Google Apps Script ได้ โดย API นี้จะให้สิทธิ์เข้าถึง Display &Video API แบบเป็นโปรแกรม

นี่คือบริการขั้นสูงที่ต้อง เปิดใช้ก่อนใช้งาน.

ข้อมูลอ้างอิง

ดูข้อมูลโดยละเอียดเกี่ยวกับบริการนี้ได้ที่ เอกสารอ้างอิงสำหรับ DV360 API บริการ DV360 ใช้ออบเจ็กต์ เมธอด และพารามิเตอร์เดียวกันกับ API สาธารณะ เช่นเดียวกับบริการขั้นสูงทั้งหมดใน Apps Script ดูข้อมูลเพิ่มเติมได้ที่ วิธีกำหนดลายเซ็นเมธอด

หากต้องการรายงานปัญหาและดูการสนับสนุนอื่นๆ โปรดดู คู่มือการสนับสนุน DV360

โค้ดตัวอย่าง

โค้ดตัวอย่างต่อไปนี้ใช้ API เวอร์ชัน 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);
  }
}