委刊項有許多父項資源，可以從這些父項資源繼承設定和指定目標。您可使用 Display & Video 360 API 建立、擷取及更新這些資源。本頁將說明資源階層結構，並提供範例，說明如何使用 Display & Video 360 API 建立這些資源。
資源階層結構
在 Display & Video 360 中，特定資源階層會將設定納入考量，每項資源放送廣告的目的都不同。從最低階層開始：
- 委刊項資源可控管放送的廣告、廣告放送時間和目標對象。
- YouTube 與合作夥伴委刊項也有廣告群組和廣告子資源。這類廣告活動可在單一委刊項預算下提供額外指定層級。YouTube 與合作夥伴委刊項 您無法使用 API 編輯商品、廣告群組、廣告和指定目標。
- 廣告訂單包含多個委刊項。它們會提供缺少委刊項設定的預設值。
- 廣告活動包含多個廣告訂單。不會強制執行廣告訂單的設定他們的設定可做為影格的框架，用來評估在其中放送廣告的進度和成效。
- 廣告客戶擁有多個廣告活動，針對旗下所放送的廣告，強制執行品牌安全指定及其他一般設定。這類物件也擁有在其中所放送廣告的廣告素材物件，並提供指定目標所使用資源的存取權。
- 夥伴擁有多個廣告客戶，針對這些廣告客戶 強制執行進一步的品牌安全指定及其他設定。以及用於指定目標及用於轉換追蹤的 Floodlight 活動的資源。您無法透過 API 編輯合作夥伴。
繼承
委刊項會沿用上層資源的多項設定和存取權。 管理委刊項和廣告放送作業時，請考量以下沿用的特質：
- 可用的廣告素材和 Floodlight 活動：委刊項只能存取上層夥伴或廣告客戶擁有的資源。廣告素材
是在廣告客戶底下建立，Floodlight 活動則為合作夥伴所有。
指派給
LineItem資源欄位creativeIds和conversionCounting的資源必須分別共用相同的上層廣告客戶和合作夥伴。 - 可存取的指定實體：系統會將管道、合併目標對象等資源用於指定目標。委刊項只能透過上層夥伴或廣告主存取的資源指定。
- 品牌安全指定：委刊項會沿用夥伴和廣告客戶層級設定的指定目標。您無法移除繼承的指定目標。這個現有指定目標可透過指派指定目標選項的
inheritance欄位識別，並影響可以套用進一步指定目標的功能。
建立資源
上述所有資源都可以透過 Display & Video 360 API 管理。以下提供簡單的程式碼範例，說明如何使用提供的用戶端程式庫建立上述各項資源。
建立廣告客戶
以下舉例說明如何建立廣告客戶：
Java
// Create an advertiser object.
Advertiser advertiser = new Advertiser();
advertiser.setPartnerId(partner-id);
advertiser.setDisplayName(display-name);
advertiser.setEntityStatus("ENTITY_STATUS_ACTIVE");
// Create and set the advertiser general configuration.
AdvertiserGeneralConfig advertiserGeneralConfig = new AdvertiserGeneralConfig();
advertiserGeneralConfig.setDomainUrl(domain-url);
advertiserGeneralConfig.setCurrencyCode("USD");
advertiser.setGeneralConfig(advertiserGeneralConfig);
// Create the ad server configuration structure.
AdvertiserAdServerConfig advertiserAdServerConfig = new AdvertiserAdServerConfig();
// Create and add the third party only configuration to the ad server
// configuration.
advertiserAdServerConfig.setThirdPartyOnlyConfig(new ThirdPartyOnlyConfig());
// Set the ad server configuration.
advertiser.setAdServerConfig(advertiserAdServerConfig);
// Create and set the creative configuration.
advertiser.setCreativeConfig(new AdvertiserCreativeConfig());
// Create and set the billing configuration.
AdvertiserBillingConfig advertiserBillingConfig = new AdvertiserBillingConfig();
advertiserBillingConfig.setBillingProfileId(billing-profile-id);
advertiser.setBillingConfig(advertiserBillingConfig);
// Configure the create request.
Advertisers.Create request = service.advertisers().create(advertiser);
// Create the advertiser.
Advertiser response = request.execute();
// Display the new advertiser.
System.out.printf("Advertiser %s was created.", response.getName());
Python
# Create an advertiser object.
advertiser_obj = {
'partnerId': partner-id,
'displayName': display-name,
'entityStatus': "ENTITY_STATUS_ACTIVE",
'generalConfig': {
'domainUrl' : domain-url,
'currencyCode' : 'USD'
},
'adServerConfig': {
'thirdPartyOnlyConfig' : {}
},
'creativeConfig': {},
'billingConfig': {
'billingProfileId' : billing-profile-id
}
}
# Create the advertiser.
advertiser = service.advertisers().create(
body=advertiser_obj
).execute()
# Display the new advertiser.
print("Advertiser %s was created." % advertiser["name"])
PHP
// Create an advertiser object.
$advertiser = new Google_Service_DisplayVideo_Advertiser();
$advertiser->setPartnerId(partner-id);
$advertiser->setDisplayName(display-name);
$advertiser->setEntityStatus('ENTITY_STATUS_ACTIVE');
// Create and set the advertiser general configuration.
$generalConfig =
new Google_Service_DisplayVideo_AdvertiserGeneralConfig();
$generalConfig->setDomainUrl(domain-url);
$generalConfig->setCurrencyCode('USD');
$advertiser->setGeneralConfig($generalConfig);
// Create the ad server configuration structure.
$adServerConfig =
new Google_Service_DisplayVideo_AdvertiserAdServerConfig();
// Create and add the third party only configuration to the ad server
// configuration.
$adServerConfig->setThirdPartyOnlyConfig(
new Google_Service_DisplayVideo_ThirdPartyOnlyConfig()
);
// Set the ad server configuration.
$advertiser->setAdServerConfig($adServerConfig);
// Create and set the creative configuration.
$advertiser->setCreativeConfig(
new Google_Service_DisplayVideo_AdvertiserCreativeConfig()
);
// Create and set the billing configuration.
$billingConfig = new Google_Service_DisplayVideo_AdvertiserBillingConfig();
$billingConfig->setBillingProfileId(billing-profile-id);
$advertiser->setBillingConfig($billingConfig);
// Call the API, creating the advertiser.
$result = $this->service->advertisers->create($advertiser);
printf('Advertiser %s was created.\n', $result['name']);
建立廣告活動
以下舉例說明如何建立廣告活動：
Java
// Create a campaign object.
Campaign campaign = new Campaign();
campaign.setDisplayName(display-name);
campaign.setEntityStatus("ENTITY_STATUS_PAUSED");
// Create a campaign goal object.
CampaignGoal campaignGoal = new CampaignGoal();
campaignGoal.setCampaignGoalType("CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS");
// Create and add a performance goal to the campaign goal object.
PerformanceGoal performanceGoal = new PerformanceGoal();
performanceGoal.setPerformanceGoalType("PERFORMANCE_GOAL_TYPE_CPC");
performanceGoal.setPerformanceGoalAmountMicros(1000000L);
campaignGoal.setPerformanceGoal(performanceGoal);
// Set the campaign goal.
campaign.setCampaignGoal(campaignGoal);
// Create a campaign flight object.
// This object details the planned spend and duration of the campaign.
CampaignFlight campaignFlight = new CampaignFlight();
campaignFlight.setPlannedSpendAmountMicros(1000000L);
// Create the date range for the campaign flight.
DateRange dateRange = new DateRange();
// Set the start date to one week from now and the end date to two weeks
// from now.
Calendar calendarStartDate = Calendar.getInstance().add(Calendar.DATE, 7);
Calendar calendarEndDate = Calendar.getInstance().add(Calendar.DATE, 14);
dateRange.setStartDate(
new Date()
.setYear(calendarStartDate.get(Calendar.YEAR))
.setMonth(calendarStartDate.get(Calendar.MONTH))
.setDay(calendarStartDate.get(Calendar.DAY_OF_MONTH)));
dateRange.setEndDate(
new Date()
.setYear(calendarEndDate.get(Calendar.YEAR))
.setMonth(calendarEndDate.get(Calendar.MONTH))
.setDay(calendarEndDate.get(Calendar.DAY_OF_MONTH)));
// Add the planned date range to the campaign flight object.
campaignFlight.setPlannedDates(dateRange);
// Set the campaign flight.
campaign.setCampaignFlight(campaignFlight);
// Create and set the frequency cap.
FrequencyCap frequencyCap = new FrequencyCap();
frequencyCap.setMaxImpressions(10);
frequencyCap.setTimeUnit("TIME_UNIT_DAYS");
frequencyCap.setTimeUnitCount(1);
campaign.setFrequencyCap(frequencyCap);
// Configure the create request.
Campaigns.Create request = service.advertisers().campaigns()
.create(advertiser-id, campaign);
// Create the campaign.
Campaign response = request.execute();
// Display the new campaign.
System.out.printf("Campaign %s was created.", response.getName());
Python
# Create a future campaign flight start and end dates.
startDate = date.today() + timedelta(days=7)
endDate = date.today() + timedelta(days=14)
# Create a campaign object.
campaign_obj = {
'displayName': display-name,
'entityStatus': 'ENTITY_STATUS_PAUSED',
'campaignGoal': {
'campaignGoalType' : 'CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS',
'performanceGoal': {
'performanceGoalType': 'PERFORMANCE_GOAL_TYPE_CPC',
'performanceGoalAmountMicros': 1000000
}
},
'campaignFlight': {
'plannedSpendAmountMicros': 1000000,
'plannedDates': {
'startDate': {
'year': startDate.year,
'month': startDate.month,
'day': startDate.day
},
'endDate': {
'year': endDate.year,
'month': endDate.month,
'day': endDate.day
}
}
},
'frequencyCap': {
'maxImpressions': 10,
'timeUnit': 'TIME_UNIT_DAYS',
'timeUnitCount': 1
}
}
# Create the campaign.
campaign = service.advertisers().campaigns().create(
advertiserId=advertiser-id,
body=campaign_obj
).execute()
# Display the new campaign.
print("Campaign %s was created." % campaign["name"])
PHP
// Create a campaign object.
$campaign = new Google_Service_DisplayVideo_Campaign();
$campaign->setDisplayName(display-name);
$campaign->setEntityStatus('ENTITY_STATUS_ACTIVE');
// Create a campaign goal object.
$campaignGoal = new Google_Service_DisplayVideo_CampaignGoal();
$campaignGoal->setCampaignGoalType(
'CAMPAIGN_GOAL_TYPE_BRAND_AWARENESS'
);
// Create and add a performance goal to the campaign goal object.
$performanceGoal = new Google_Service_DisplayVideo_PerformanceGoal();
$performanceGoal->setPerformanceGoalType('PERFORMANCE_GOAL_TYPE_CPC');
$performanceGoal->setPerformanceGoalAmountMicros(1000000);
// Set the campaign goal.
$campaignGoal->setPerformanceGoal($performanceGoal);
$campaign->setCampaignGoal($campaignGoal);
// Create a campaign flight object.
// This object details the planned spend and duration of the campaign.
$campaignFlight = new Google_Service_DisplayVideo_CampaignFlight();
$campaignFlight->setPlannedSpendAmountMicros(1000000);
// Create a date range object for the flight.
$dateRange = new Google_Service_DisplayVideo_DateRange();
// Create and assign a start date one week from now.
$startDateTime = new DateTime('today + 7 days');
$startDate = new Google_Service_DisplayVideo_Date();
$startDate->setYear($startDateTime->format('Y'));
$startDate->setMonth($startDateTime->format('n'));
$startDate->setDay($startDateTime->format('j'));
$dateRange->setStartDate($startDate);
// Create and assign an end date two weeks from now.
$endDateTime = new DateTime('today + 14 days');
$endDate = new Google_Service_DisplayVideo_Date();
$endDate->setYear($endDateTime->format('Y'));
$endDate->setMonth($endDateTime->format('n'));
$endDate->setDay($endDateTime->format('j'));
$dateRange->setendDate($endDate);
// Assign date range to flight.
$campaignFlight->setPlannedDates($dateRange);
// Assign flight to campaign.
$campaign->setCampaignFlight($campaignFlight);
// Create and set the frequency cap.
$frequencyCap = new Google_Service_DisplayVideo_FrequencyCap();
$frequencyCap->setMaxImpressions(10);
$frequencyCap->setTimeUnit('TIME_UNIT_DAYS');
$frequencyCap->setTimeUnitCount(1);
$campaign->setFrequencyCap($frequencyCap);
// Call the API, creating the campaign under the given advertiser.
$result = $this->service->advertisers_campaigns->create(
advertiser-id,
$campaign
);
// Display the new campaign.
printf('Campaign %s was created.\n', $result['name']);
建立插入委刊單
以下舉例說明如何建立廣告訂單：
Java
// Create an insertion order object.
InsertionOrder insertionOrder = new InsertionOrder();
insertionOrder.setCampaignId(campaign-id);
insertionOrder.setDisplayName(display-name);
insertionOrder.setEntityStatus("ENTITY_STATUS_DRAFT");
// Create and add the pacing setting.
Pacing pacing = new Pacing();
pacing.setPacingPeriod("PACING_PERIOD_DAILY");
pacing.setPacingType("PACING_TYPE_EVEN");
pacing.setDailyMaxMicros(10000L);
insertionOrder.setPacing(pacing);
// Create and set the frequency cap.
FrequencyCap frequencyCap = new FrequencyCap();
frequencyCap.setTimeUnit("TIME_UNIT_DAYS");
frequencyCap.setTimeUnitCount(1);
frequencyCap.setMaxImpressions(10);
insertionOrder.setFrequencyCap(frequencyCap);
// Create and set the key performance indicator (KPI).
Kpi kpi = new Kpi();
kpi.setKpiType("KPI_TYPE_CPC");
kpi.setKpiAmountMicros(1000000L);
insertionOrder.setKpi(kpi);
// Create a budget object.
InsertionOrderBudget insertionOrderBudget = new InsertionOrderBudget();
insertionOrderBudget.setBudgetUnit("BUDGET_UNIT_CURRENCY");
// Create a budget segment object.
InsertionOrderBudgetSegment insertionOrderBudgetSegment =
new InsertionOrderBudgetSegment();
insertionOrderBudgetSegment.setBudgetAmountMicros(100000L);
// Create the date range for the budget segment.
DateRange dateRange = new DateRange();
// Set the start date to one week from now and the end date to two weeks
// from now.
Calendar calendarStartDate = Calendar.getInstance().add(Calendar.DATE, 7);
Calendar calendarEndDate = Calendar.getInstance().add(Calendar.DATE, 14);
dateRange.setStartDate(
new Date()
.setYear(calendarStartDate.get(Calendar.YEAR))
.setMonth(calendarStartDate.get(Calendar.MONTH))
.setDay(calendarStartDate.get(Calendar.DAY_OF_MONTH)));
dateRange.setEndDate(
new Date()
.setYear(calendarEndDate.get(Calendar.YEAR))
.setMonth(calendarEndDate.get(Calendar.MONTH))
.setDay(calendarEndDate.get(Calendar.DAY_OF_MONTH)));
// Add the date range to the budget segment.
insertionOrderBudgetSegment.setDateRange(dateRange);
// Add budget segment list to the budget.
insertionOrderBudget
.setBudgetSegments(ImmutableList.of(insertionOrderBudgetSegment));
// Set budget.
insertionOrder.setBudget(insertionOrderBudget);
// Configure the create request.
InsertionOrders.Create request =
service.advertisers().insertionOrders()
.create(advertiser-id, insertionOrder);
// Create the insertion order.
InsertionOrder response = request.execute();
// Display the new insertion order.
System.out.printf("InsertionOrder %s was created.", response.getName());
Python
# Create a future budget segment start and end dates.
startDate = date.today() + timedelta(days=7)
endDate = date.today() + timedelta(days=14)
# Create an insertion order object.
insertion_order_obj = {
'campaignId' : campaign-id,
'displayName': display-name,
'entityStatus': 'ENTITY_STATUS_DRAFT',
'pacing': {
'pacingPeriod': 'PACING_PERIOD_DAILY',
'pacingType': 'PACING_TYPE_EVEN',
'dailyMaxMicros': 10000
},
'frequencyCap': {
'maxImpressions': 10,
'timeUnit': 'TIME_UNIT_DAYS',
'timeUnitCount': 1
},
'kpi' : {
'kpiType': 'KPI_TYPE_CPC',
'kpiAmountMicros': 1000000
},
'budget': {
'budgetUnit': 'BUDGET_UNIT_CURRENCY',
'budgetSegments': [
{
'budgetAmountMicros': 100000,
'dateRange': {
'startDate': {
'year': startDate.year,
'month': startDate.month,
'day': startDate.day
},
'endDate': {
'year': endDate.year,
'month': endDate.month,
'day': endDate.day
}
}
}
]
}
}
# Create the insertion order.
insertionOrder = service.advertisers().insertionOrders().create(
advertiserId=advertiser-id,
body=insertion_order_obj
).execute()
# Display the new insertion order.
print("Insertion Order %s was created." % insertionOrder["name"])
PHP
// Create an insertion order object.
$insertionOrder = new Google_Service_DisplayVideo_InsertionOrder();
$insertionOrder->setCampaignId(campaign-id);
$insertionOrder->setDisplayName(display-name);
$insertionOrder->setEntityStatus('ENTITY_STATUS_DRAFT');
// Create and add the pacing setting.
$pacing = new Google_Service_DisplayVideo_Pacing();
$pacing->setPacingPeriod('PACING_PERIOD_DAILY');
$pacing->setPacingType('PACING_TYPE_EVEN');
$pacing->setDailyMaxMicros(10000);
$insertionOrder->setPacing($pacing);
// Create and set the frequency cap.
$frequencyCap = new Google_Service_DisplayVideo_FrequencyCap();
$frequencyCap->setMaxImpressions(10);
$frequencyCap->setTimeUnit('TIME_UNIT_DAYS');
$frequencyCap->setTimeUnitCount(1);
$insertionOrder->setFrequencyCap($frequencyCap);
// Create and set the key performance indicator (KPI).
$kpi = new Google_Service_DisplayVideo_Kpi();
$kpi->setKpiType('KPI_TYPE_CPC');
$kpi->setKpiAmountMicros(1000000);
$insertionOrder->setKpi($kpi);
// Create a budget object.
$budget = new Google_Service_DisplayVideo_InsertionOrderBudget();
$budget->setBudgetUnit('BUDGET_UNIT_CURRENCY');
// Create a budget segment object.
$budgetSegment =
new Google_Service_DisplayVideo_InsertionOrderBudgetSegment();
$budgetSegment->setBudgetAmountMicros(100000);
// Create a date range object for the budget segment.
$dateRange = new Google_Service_DisplayVideo_DateRange();
// Create and assign a start date one week from now.
$startDateTime = new DateTime('today + 7 days');
$startDate = new Google_Service_DisplayVideo_Date();
$startDate->setYear($startDateTime->format('Y'));
$startDate->setMonth($startDateTime->format('n'));
$startDate->setDay($startDateTime->format('j'));
$dateRange->setStartDate($startDate);
// Create and assign an end date two weeks from now.
$endDateTime = new DateTime('today + 14 days');
$endDate = new Google_Service_DisplayVideo_Date();
$endDate->setYear($endDateTime->format('Y'));
$endDate->setMonth($endDateTime->format('n'));
$endDate->setDay($endDateTime->format('j'));
$dateRange->setendDate($endDate);
// Assign date range to budget segment.
$budgetSegment->setDateRange($dateRange);
// Set budget segment.
$budget->setBudgetSegments(array($budgetSegment));
// Set budget object.
$insertionOrder->setBudget($budget);
// Call the API, creating the insertion order under the advertiser and
// campaign given.
$result = $this->service->advertisers_insertionOrders->create(
advertiser-id,
$insertionOrder
);
printf('Insertion Order %s was created.\n', $result['name']);
建立委刊項
以下範例說明如何建立委刊項：
Java
// Create a line item object.
LineItem lineItem = new LineItem();
lineItem.setInsertionOrderId(insertion-order-id);
lineItem.setDisplayName(display-name);
lineItem.setLineItemType("LINE_ITEM_TYPE_DISPLAY_DEFAULT");
lineItem.setEntityStatus("ENTITY_STATUS_DRAFT");
// Create and set the line item flight.
LineItemFlight lineItemFlight = new LineItemFlight();
lineItemFlight
.setFlightDateType("LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED");
lineItem.setFlight(lineItemFlight);
// Create and set the line item budget.
LineItemBudget lineItemBudget = new LineItemBudget();
lineItemBudget
.setBudgetAllocationType("LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED");
lineItem.setBudget(lineItemBudget);
// Create and set the pacing setting.
Pacing pacing = new Pacing();
pacing.setPacingPeriod("PACING_PERIOD_DAILY");
pacing.setPacingType("PACING_TYPE_EVEN");
pacing.setDailyMaxMicros(10000L);
lineItem.setPacing(pacing);
// Create and set the frequency cap.
FrequencyCap frequencyCap = new FrequencyCap();
frequencyCap.setTimeUnit("TIME_UNIT_DAYS");
frequencyCap.setTimeUnitCount(1);
frequencyCap.setMaxImpressions(10);
lineItem.setFrequencyCap(frequencyCap);
// Create and set the partner revenue model.
PartnerRevenueModel partnerRevenueModel = new PartnerRevenueModel();
partnerRevenueModel
.setMarkupType("PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM");
partnerRevenueModel.setMarkupAmount(10L);
lineItem.setPartnerRevenueModel(partnerRevenueModel);
// Set the list of IDs of the creatives associated with the line item.
lineItem.setCreativeIds(creative-ids);
// Create and set the bidding strategy.
BiddingStrategy biddingStrategy = new BiddingStrategy();
biddingStrategy
.setFixedBid(new FixedBidStrategy().setBidAmountMicros(100000L));
lineItem.setBidStrategy(biddingStrategy);
// Configure the create request.
LineItems.Create request =
service.advertisers().lineItems().create(advertiser-id, lineItem);
// Create the line item.
LineItem response = request.execute();
// Display the new line item.
System.out.printf("LineItem %s was created.", response.getName());
Python
# Create an line item object.
line_item_obj = {
'insertionOrderId' : insertion-order-id,
'displayName': display-name,
'lineItemType': 'LINE_ITEM_TYPE_DISPLAY_DEFAULT',
'entityStatus': 'ENTITY_STATUS_DRAFT',
'flight': {
'flightDateType': 'LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED'
},
'budget': {
'budgetAllocationType': 'LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED'
},
'pacing': {
'pacingPeriod': 'PACING_PERIOD_DAILY',
'pacingType': 'PACING_TYPE_EVEN',
'dailyMaxMicros': 10000
},
'frequencyCap': {
'timeUnit': 'TIME_UNIT_DAYS',
'timeUnitCount': 1,
'maxImpressions': 10
},
'partnerRevenueModel': {
'markupType': 'PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM',
'markupAmount': 10
},
'creativeIds': creative-ids,
'bidStrategy': {
'fixedBid': {
'bidAmountMicros': 100000
}
}
}
# Create the line item.
lineItem = service.advertisers().lineItems().create(
advertiserId=advertiser-id,
body=line_item_obj
).execute()
# Display the new line item.
print("Line Item %s was created." % lineItem["name"])
PHP
// Create a line item object.
$lineItem = new Google_Service_DisplayVideo_LineItem();
$lineItem->setInsertionOrderId(insertion-order-id);
$lineItem->setDisplayName(display-name);
$lineItem->setLineItemType('LINE_ITEM_TYPE_DISPLAY_DEFAULT');
$lineItem->setEntityStatus('ENTITY_STATUS_DRAFT');
// Create and set the line item flight.
$flight = new Google_Service_DisplayVideo_LineItemFlight();
$flight->setFlightDateType('LINE_ITEM_FLIGHT_DATE_TYPE_INHERITED');
$lineItem->setFlight($flight);
// Create and set the line item budget.
$budget = new Google_Service_DisplayVideo_LineItemBudget();
$budget->setBudgetAllocationType(
'LINE_ITEM_BUDGET_ALLOCATION_TYPE_FIXED'
);
$lineItem->setBudget($budget);
// Create and set the pacing setting.
$pacing = new Google_Service_DisplayVideo_Pacing();
$pacing->setPacingPeriod('PACING_PERIOD_DAILY');
$pacing->setPacingType('PACING_TYPE_EVEN');
$pacing->setDailyMaxMicros(10000);
$lineItem->setPacing($pacing);
// Create and set the frequency cap.
$frequencyCap = new Google_Service_DisplayVideo_FrequencyCap();
$frequencyCap->setMaxImpressions(10);
$frequencyCap->setTimeUnit('TIME_UNIT_DAYS');
$frequencyCap->setTimeUnitCount(1);
$lineItem->setFrequencyCap($frequencyCap);
// Create and set the partner revenue model.
$partnerRevenueModel =
new Google_Service_DisplayVideo_PartnerRevenueModel();
$partnerRevenueModel->setMarkupType(
'PARTNER_REVENUE_MODEL_MARKUP_TYPE_CPM'
);
$partnerRevenueModel->setMarkupAmount(10);
$lineItem->setPartnerRevenueModel($partnerRevenueModel);
// Set the list of IDs of the creatives associated with the line item.
lineItem >setCreativeIds(creative-ids);
// Create and set the bidding strategy.
$biddingStrategy = new Google_Service_DisplayVideo_BiddingStrategy();
$fixedBidStrategy = new Google_Service_DisplayVideo_FixedBidStrategy();
$fixedBidStrategy->setBidAmountMicros(100000);
$biddingStrategy->setFixedBid($fixedBidStrategy);
$lineItem->setBidStrategy($biddingStrategy);
// Create the line item.
$result = $this->service->advertisers_lineItems->create(
advertiser-id,
$lineItem
);
printf('Line Item %s was created.\n', $result['name']);
產生預設委刊項
委刊項可根據指定的 LineItemType 及上層廣告訂單的現有設定，使用預設設定產生。與建立標準 API 委刊項不同，系統在產生預設委刊項時，會指派與上層廣告訂單相同的指定目標，類似 UI 中的指定目標。使用廣告訂單
AssignedTargetingOptions 服務進行管理
以下範例說明如何產生預設委刊項：
Java
// Create a default line item generation request.
GenerateDefaultLineItemRequest defaultLineItemRequest =
new GenerateDefaultLineItemRequest();
defaultLineItemRequest.setInsertionOrderId(insertion-order-id);
defaultLineItemRequest.setDisplayName(display-name);
defaultLineItemRequest.setLineItemType("LINE_ITEM_TYPE_DISPLAY_DEFAULT");
// Configure the request.
LineItems.GenerateDefault request =
service
.advertisers()
.lineItems()
.generateDefault(advertiser-id, defaultLineItemRequest);
// Generate the default line item.
LineItem response = request.execute();
// Display the new line item.
System.out.printf("LineItem %s was created.", response.getName());
Python
# Create a default line item generation request.
default_li_request = {
'insertionOrderId' : insertion-order-id,
'displayName': display-name,
'lineItemType': 'LINE_ITEM_TYPE_DISPLAY_DEFAULT'
}
# Generate the default line item.
line_item = service.advertisers().lineItems().generateDefault(
advertiserId=advertiser-id,
body=default_li_request
).execute()
# Display the new line item.
print("Line Item %s was created." % lineItem["name"])
PHP
// Create a default line item generation request.
$defaultLineItemRequest =
new Google_Service_DisplayVideo_GenerateDefaultLineItemRequest();
$defaultLineItemRequest->setInsertionOrderId(insertion-order-id);
$defaultLineItemRequest->setDisplayName(display-name);
$defaultLineItemRequest->setLineItemType('LINE_ITEM_TYPE_DISPLAY_DEFAULT');
// Generate the default line item.
$result = $this->service->advertisers_lineItems->generateDefault(
advertiser-id,
$defaultLineItemRequest
);
// Display the new line item.
printf('Line Item %s was created.\n', $result['name']);
複製委刊項
現有委刊項可以複製；新委刊項的設定和指定目標設定，會與在相同廣告訂單中建立的現有委刊項相同。
以下範例說明如何複製現有委刊項：
Java
// Create the duplicate line item request body.
DuplicateLineItemRequest requestBody = new DuplicateLineItemRequest();
requestBody.setTargetDisplayName(target-display-name);
// Configure the request.
LineItems.Duplicate request = service.advertisers().lineItems()
.duplicate(advertiser-id, line-item-id, requestBody);
// Duplicate the line item.
DuplicateLineItemResponse response = request.execute();
// Display the line item ID of the new duplicate line item.
System.out.printf("A duplicate line item with the ID %s was created.",
response.getDuplicateLineItemId());
Python
# Create the duplicate line item request body.
duplicate_request = {
'targetDisplayName': target-display-name
}
# Duplicate the line item.
response = service.advertisers().lineItems().duplicate(
advertiserId=advertiser-id,
lineItemId=line-item-id,
body=duplicate_request
).execute()
# Display the line item ID of the new duplicate line item.
print("A duplicate line item with the ID %s was created."
% response["duplicateLineItemId"])
PHP
// Create the duplicate line item request body.
$requestBody = new Google_Service_DisplayVideo_DuplicateLineItemRequest();
$requestBody->setTargetDisplayName(target-display-name);
// Call the API, duplicating the line item.
$response = $service
->advertisers_lineItems
->duplicate(
advertiser-id,
line-item-id,
$requestBody
);
// Display the line item ID of the new duplicate line item.
printf(
'A duplicate line item with the ID %s was created.',
$response->getDuplicateLineItemId()
);