Layanan Display & Video 360

Layanan Display & Video 360 (DV360) memungkinkan Anda menggunakan DV360 API di Apps Script. API ini menyediakan akses terprogram ke Display & Video API.

Catatan: Ini adalah layanan lanjutan yang harus diaktifkan sebelum digunakan.

Referensi

Untuk mengetahui informasi mendetail tentang layanan ini, lihat dokumentasi referensi untuk DV360 API. Seperti semua layanan lanjutan di Apps Script, layanan DV360 menggunakan objek, metode, dan parameter yang sama dengan API publik. Untuk mengetahui informasi selengkapnya, lihat Cara menentukan tanda tangan metode.

Untuk melaporkan masalah dan menemukan dukungan lainnya, lihat panduan dukungan DV360.

Kode contoh

Contoh kode berikut menggunakan API versi 4.

Mendapatkan daftar partner

Contoh ini mencatat semua partner yang tersedia di akun.

advanced/displayvideo.gs

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

Mendapatkan daftar kampanye aktif

Contoh ini mencatat nama dan ID semua kampanye aktif. Perhatikan penggunaan token penomoran halaman untuk mengambil seluruh daftar.

advanced/displayvideo.gs

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

Memperbarui nama tampilan item baris

Contoh ini memperbarui nama tampilan item baris

advanced/displayvideo.gs

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