Display & Video 360 서비스

Display & Video 360 (DV360) 서비스를 사용하면 Apps Script에서 DV360 API를 사용할 수 있습니다. 이 API는 Display & Video API에 대한 프로그래매틱 액세스를 제공합니다.

참고: 이 서비스는 사용 전에 사용 설정해야 하는 고급 서비스입니다.

참조

이 서비스에 대한 자세한 내용은 DV360 API의 참조 문서를 참고하세요. Apps Script의 모든 고급 서비스와 마찬가지로 DV360 서비스는 공개 API와 동일한 객체, 메서드, 매개변수를 사용합니다. 자세한 내용은 메서드 서명이 결정되는 방식을 참고하세요.

문제를 신고하고 기타 지원을 받으려면 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);
  }
}

활성 캠페인 목록 가져오기

이 샘플은 모든 활성 캠페인의 이름과 ID를 로깅합니다. 전체 목록을 가져오기 위해 페이지로 나누기 토큰을 사용합니다.

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