這些指定目標選項、指派的指定目標選項和委刊項服務都可以在 Display & Video 360 API 中設定委刊項指定目標。本頁面提供範例說明如何尋找可用指定目標選項、為委刊項指派指定目標選項,以及對委刊項執行大量操作,以便列出及編輯指派的指定目標選項。
查看可用的指定目標選項
指定選項會使用使用者指定變數、現有的可指定實體或現有選項來定義所需的目標對象。視指定類型而定,系統會使用列舉值或指定目標選項 ID 識別現有選項。系統會使用實體 ID 識別可指定的實體。您可以使用 Display & Video 360 API 找到指定選項 ID 和實體 ID。
使用設定的列舉值
下列指定類型的指定目標選項是使用特定的列舉類型指派:
TargetingType |
列舉 |
---|---|
TARGETING_TYPE_AGE_RANGE |
AgeRange |
TARGETING_TYPE_CONTENT_INSTREAM_POSITION |
ContentInstreamPosition |
TARGETING_TYPE_CONTENT_OUTSTREAM_POSITION |
ContentOutstreamPosition |
TARGETING_TYPE_DEVICE_TYPE |
DeviceType |
TARGETING_TYPE_DIGITAL_CONTENT_LABEL_EXCLUSION |
ContentRatingTier |
TARGETING_TYPE_ENVIRONMENT |
Environment |
TARGETING_TYPE_EXCHANGE |
Exchange |
TARGETING_TYPE_GENDER |
Gender |
TARGETING_TYPE_HOUSEHOLD_INCOME |
HouseholdIncome |
TARGETING_TYPE_NATIVE_CONTENT_POSITION |
NativeContentPosition |
TARGETING_TYPE_OMID |
Omid |
TARGETING_TYPE_PARENTAL_STATUS |
ParentalStatus |
TARGETING_TYPE_SENSITIVE_CATEGORY_EXCLUSION |
SensitiveCategory |
TARGETING_TYPE_VIDEO_PLAYER_SIZE |
VideoPlayerSize |
TARGETING_TYPE_VIEWABILITY |
Viewability |
相關列舉值的字串版本可用於識別這些指定類型的現有 AssignedTargetingOption
資源,且可在 assignedTargetingOptionIdAlias
欄位中使用。擷取或刪除已指派的指定目標選項時,您可以使用這個別名值來取代 assignedTargetingOptionId
。
擷取指定目標選項 ID
使用現有選項的指定類型會使用對應的指定選項 ID 指派。
舉例來說,您可以使用指定類型 TARGETING_TYPE_ON_SCREEN_POSITION
來指定畫面上的位置,數量有限。每個位置都有對應的指定目標選項 ID。
這些指定目標選項 ID 可透過指定選項服務擷取。視指定類型而定,擷取作業會透過以下其中一種方式完成:
- 個別擷取或完整清單:您可以使用
get
和list
方法擷取大部分指定類型的選項。請使用targetingTypes.targetingOptions.get
擷取指定選項 ID 和指定選項 ID 識別的指定目標選項詳細資料。使用targetingTypes.targetingOptions.list
列出特定指定類型的所有可用指定選項。 - 搜尋:地區指定類型 (
TARGETING_TYPE_GEO_REGION
、TARGETING_TYPE_POI
和TARGETING_TYPE_BUSINESS_CHAIN
) 的選項必須使用search
方法擷取。使用targetingTypes.targetingOptions.search
,即可擷取與指定查詢字串相符的指定類型指定選項。
以下範例說明如何擷取指定類型 TARGETING_TYPE_BROWSER
的可能指定目標選項清單:
Java
// Configure the list request. TargetingOptions.List request = service .targetingTypes() .targetingOptions() .list("TARGETING_TYPE_BROWSER") .setAdvertiserId(advertiser-id); // Create the response and nextPageToken variables. ListTargetingOptionsResponse response; String nextPageToken = null; do { // Create and execute the list request. response = request.setPageToken(nextPageToken).execute(); // Check if the response is empty. if (response.isEmpty()) { System.out.print("List request returned no Targeting Options"); break; } // Iterate over retrieved targeting options. for (TargetingOption option : response.getTargetingOptions()) { System.out.printf( "Targeting Option ID: %s, Browser Display Name: '%s'\n", option.getTargetingOptionId(), option.getBrowserDetails().getDisplayName()); } // Update the next page token. nextPageToken = response.getNextPageToken(); } while (!Strings.isNullOrEmpty(nextPageToken));
Python
# Create the page token variable. next_page_token = "" while True: # Request the targeting options list. response = service.targetingTypes() \ .targetingOptions().list( advertiserId=advertiser-id, targetingType="TARGETING_TYPE_BROWSER", pageToken=next_page_token ).execute() # Check if response is empty. if not response: print("List request returned no Targeting Options") break # Iterate over retrieved targeting options. for option in response['targetingOptions']: print("Targeting Option ID: %s, Browser Display Name: %s" % (option['targetingOptionId'], option['browserDetails']['displayName'])) # Break out of loop if there is no next page. if 'nextPageToken' not in response: break # Update the next page token. next_page_token = response['nextPageToken']
PHP
// Create the page token variable. $nextPageToken = null; do { // Build the query parameters object for the request. $optParams = array( 'advertiserId' => advertiser-id, 'pageToken' => $nextPageToken ); // Call the API, getting the browser targeting options for the // identified advertiser. $response = $this ->service ->targetingTypes_targetingOptions ->listTargetingTypesTargetingOptions( 'TARGETING_TYPE_BROWSER', $optParams ); // Print the resulting targeting options. if (!empty($response->getTargetingOptions())) { foreach ($response->getTargetingOptions() as $option) { printf( 'Targeting Option ID: %s, Browser Display Name: %s\n', $option['targetingOptionId'], $option['browserDetails']['displayName'] ); } } else { print('No targeting options returned\n'); } // Update the next page token. $nextPageToken = $response->getNextPageToken(); } while ( !empty($response->getTargetingOptions()) && $nextPageToken );
列出可指定的實體
如要使用現有的可指定實體指定委刊項,您必須具備該實體的 ID。您可透過 Display & Video 360 API 中的專屬服務擷取管道、合併目標對象和廣告空間來源群組等可指定實體。
每項服務都有專屬的 get
和 list
方法。請使用 get
方法,確認特定廣告客戶具有實體。您可以使用 list
方法,探索特定廣告客戶可使用該資源類型的所有實體,以便為該廣告客戶底下的委刊項指派指定目標。
您也可以透過 API 管理可指定的實體子集。透過對應服務中的 create
和 patch
方法,以及實體中所列個別值的服務 (例如廣告空間來源、排除關鍵字和位置) 執行上述操作。
建立搜尋點指定目標選項 ID
您可以使用 targetingTypes.targetingOptions.search
擷取 TARGETING_TYPE_POI
下方的已命名搜尋點指定選項。此外,您也可以建構專屬的 TARGETING_TYPE_POI
指定選項 ID 來指定特定的經緯度座標。
請按照下列步驟建立搜尋點指定選項 ID:
- 擷取經緯度座標 (例如「40.7414691, -74.003387」)
- 將座標值四捨五入到第六位 (例如:「40.741469, -74.003387」)
- 從座標值中移除小數位數 (例如:「40741469, -74003387」)
- 串連兩個值,讓單一字串中間以半形分號分隔 (例如:「40741469;-74003387」)
在建立 TARGETING_TYPE_POI
指派指定目標選項時,產生的字串可做為 targetingOptionId
。
建立後,指派的指定選項資源的 targetingOptionId
和 assignedTargetingOptionId
欄位會更新,並在後方加上半形分號和英數字元雜湊。
指派指定目標選項
指派給委刊項的指定目標會以「指派的指定目標選項」表示。您可以使用指派的指定選項服務管理這些實體。建立指派的指定目標選項後,系統會將這些指定目標詳細資料套用到上層委刊項。如果刪除現有的已指派指定目標選項,系統將移除該指定目標。
請使用 advertisers.lineItems.targetingTypes.assignedTargetingOptions.create
建立指派的指定目標選項。在指派指定選項資源的 details
欄位中,根據預定的指定類型指定對應參數。
以下舉例說明如何建立 TARGETING_TYPE_BROWSER
類型的指派指定選項:
Java
// Create an AssignedTargetingOption object of the // browser targeting type. AssignedTargetingOption assignedTargetingOption = new AssignedTargetingOption() .setBrowserDetails( new BrowserAssignedTargetingOptionDetails() .setTargetingOptionId(targeting-option-id)); // Configure the create request. AssignedTargetingOptions.Create request = service .advertisers() .lineItems() .targetingTypes() .assignedTargetingOptions() .create( advertiser-id, line-item-id, "TARGETING_TYPE_BROWSER", assignedTargetingOption); // Send the request. AssignedTargetingOption response = request.execute(); // Display the new assigned targeting option. System.out.printf("AssignedTargetingOption %s was created.", response.getName());
Python
# Create a assigned targeting option object. assigned_targeting_option_obj = { 'browserDetails': { 'targetingOptionId': targeting-option-id } } # Create the assigned targeting option. assigned_targeting_option = service.advertisers().lineItems()\ .targetingTypes().assignedTargetingOptions().create( advertiserId=advertiser-id, lineItemId=line-item-id, targetingType="TARGETING_TYPE_BROWSER", body=assigned_targeting_option_obj ).execute() # Display the new assigned targeting option. print("Assigned Targeting Option %s was created." % assigned_targeting_option["name"])
PHP
// Create a assigned targeting option object. $assignedTargetingOption = new Google_Service_DisplayVideo_AssignedTargetingOption(); // Create and set browser details. $details = new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails(); $details->setTargetingOptionId(targeting-option-id); $assignedTargetingOption->setBrowserDetails($details); // Call the API, creating the browser assigned targeting option for the // given line item. $result = $this ->service ->advertisers_lineItems_targetingTypes_assignedTargetingOptions ->create( advertiser-id, line-item-id, 'TARGETING_TYPE_BROWSER', $assignedTargetingOption ); printf( 'Assigned Targeting Option %s was created.\n', $result['name'] );
錯誤
指定目標設定錯誤
Display & Video 360 提供許多與指定目標相關的複雜規則。系統會在 Display & Video 360 API 中透過建立指定指定目標選項時傳回的錯誤強制執行這些函式。API 傳回的錯誤會指明違規問題。
錯誤主要是由指派給委刊項的現有指定目標所造成。使用 advertisers.lineItems.targetingTypes.assignedTargetingOptions.list
擷取指派給委刊項的特定指定類型的所有指定目標選項,評估是否在限制後有需要的指定目標,並使用 advertisers.lineItems.targetingTypes.assignedTargetingOptions.delete
移除任何不需要的指定目標,然後再嘗試建立所需的指派指定選項。
YouTube 與合作夥伴指定目標錯誤
您無法使用 Display & Video 360 API 更新 YouTube 與合作夥伴廣告活動專用的指定目標,這樣做會導致錯誤發生。
YouTube 與合作夥伴指定目標包含直接指派給 YouTube 與合作夥伴委刊項和廣告群組的所有指定目標,以及下列指定類型的任何指定目標:
TARGETING_TYPE_SESSION_POSITION
TARGETING_TYPE_YOUTUBE_CHANNEL
TARGETING_TYPE_YOUTUBE_VIDEO
並行錯誤
如果您嘗試透過多個並行要求更新單一委刊項的設定或指定目標,則會導致錯誤發生。
如果您需要同時為單一委刊項新增或移除多個指派的指定目標選項,請使用大量編輯要求。如要更新委刊項的設定和指定目標,請連續發出 advertisers.lineItems.patch
要求和相關指定目標要求,以確保在第一次傳回回應之前,系統不會傳送第二個要求。
大量和整個資源指定目標作業
您可使用「大量」和「全資源」指定方式,管理各種指定類型的指派指定目標選項:
- 使用大量指定方式,可擷取或編輯多個指定類型和多項資源下的指定目標選項。您可以使用
advertisers.lineItems.bulkListAssignedTargetingOptions
擷取多個委刊項的完整指定目標設定,或使用advertisers.lineItems.bulkEditAssignedTargetingOptions
對多個委刊項的指定目標進行相同的更新。這些內容只能在advertisers.lineItems
服務中提供。 - 使用「全資源配置方式」,在單一資源下擷取或編輯多個指定類型的指定目標選項。這些功能提供
partners
、advertisers
、advertisers.campaigns
和advertisers.insertionOrders
服務,並命名為listAssignedTargetingOptions
或editAssignedTargetingOptions
。
如果你想完整掌握委刊項目前的指定目標、想為委刊項套用預設指定目標設定,或需要同時對委刊項指定目標進行多項變更,不妨考慮使用這些指定方式。
大量指定名單
advertisers.lineItems.bulkListAssignedTargetingOptions
可讓您在不同的指定類型中查看指派給一或多個委刊項的所有指定目標。運作方式與任何其他 list
方法類似。您可以使用 filter
查詢參數,依 TargetingType
或 Inheritance
篩選結果。
以下範例說明如何列出指派給上層夥伴或廣告客戶繼承的委刊項所有指定選項:
Java
// Configure the bulk list request. LineItems.BulkListAssignedTargetingOptions request = service.advertisers().lineItems() .bulkListAssignedTargetingOptions(advertiser-id); // Set Line Items to retrieve targeting for. request.setLineItemIds(line-item-ids); // Set filter to only return inherited assigned targeting options. request.setFilter( "inheritance=\"INHERITED_FROM_ADVERTISER\" OR inheritance=\"INHERITED_FROM_PARTNER\""); // Create the response and nextPageToken variables. BulkListAssignedTargetingOptionsResponse response; String nextPageToken = null; do { // Set page token and execute the list request. response = request.setPageToken(nextPageToken).execute(); // Check if the response is empty. if (response.isEmpty()) { System.out.print("Bulk list request returned no Assigned Targeting Options"); break; } // Iterate over retrieved line item assigned targeting option wrapper objects. for (LineItemAssignedTargetingOption lineItemAssignedTargetingOption : response.getLineItemAssignedTargetingOptions()) { System.out.printf( "Assigned Targeting Option %s found\n", lineItemAssignedTargetingOption.getAssignedTargetingOption().getName()); } // Update the next page token. nextPageToken = response.getNextPageToken(); } while (!Strings.isNullOrEmpty(nextPageToken));
Python
# Create the page token variable. next_page_token = "" while True: # Execute the list request. response = service.advertisers().lineItems() \ .bulkListAssignedTargetingOptions( advertiserId=advertiser-id, lineItemIds=line-item-ids, filter="inheritance=\"INHERITED_FROM_ADVERTISER\" OR " "inheritance=\"INHERITED_FROM_PARTNER\"", pageToken=next_page_token ).execute() # Check if response is empty. if not response: print("Bulk list request returned no Assigned Targeting Options") break # Iterate over retrieved assigned targeting options. for lineItemAssignedTargetingOption in response['lineItemAssignedTargetingOptions']: print("Assigned Targeting Option %s found" % (lineItemAssignedTargetingOption['assignedTargetingOption']['name'])) # Break out of loop if there is no next page. if 'nextPageToken' not in response: break # Update the next page token. next_page_token = response['nextPageToken']
PHP
// Create the page token variable. $nextPageToken = null; do { // Build the query parameters object for the request. $optParams = array( 'lineItemIds' => line-item-ids, 'filter' => "inheritance=\"INHERITED_FROM_ADVERTISER\" OR " . "inheritance=\"INHERITED_FROM_PARTNER\"", 'pageToken' => $nextPageToken ); // Call the API, getting all the assigned targeting options for the // identified line item. $response = $service ->advertisers_lineItems ->bulkListAssignedTargetingOptions( advertiser-id, $optParams ); // Print the returned assigned targeting options. if (!empty($response->getLineItemAssignedTargetingOptions())) { foreach ($response->getLineItemAssignedTargetingOptions() as $option) { printf('Assigned Targeting Option %s found\n', $option->getAssignedTargetingOption()['name']); } } else { print('No targeting options returned\n'); } // Update the next page token. $nextPageToken = $response->getNextPageToken(); } while ( !empty($response->getLineItemAssignedTargetingOptions()) && $nextPageToken);
大量編輯指定目標
advertisers.lineItems.bulkEditAssignedTargetingOptions
可讓您從一或多個委刊項同時新增及移除各種指定類型的多個指定目標選項。
此方法會使用 DeleteAssignedTargetingOptionsRequests
和 CreateAssignedTargetingOptionsRequests
清單。單一要求物件可能代表刪除或建立相同指定類型的多個指派指定選項。
如果嘗試刪除或建立指派的指定目標選項導致委刊項發生錯誤,該委刊項的大量操作就會遭到捨棄。這項要求會傳回成功更新的委刊項清單、無法更新的委刊項清單,以及相關錯誤。
以下範例說明如何為一或多個委刊項 (特定清單選項清單) 刪除指派的指定目標選項,用於刪除,以及要建立的指定目標選項:
Java
// Create a bulk edit request. BulkEditAssignedTargetingOptionsRequest requestContent = new BulkEditAssignedTargetingOptionsRequest(); // Set line item IDs in edit request. requestContent.setLineItemIds(line-item-ids); // Build delete request list. ArrayList<DeleteAssignedTargetingOptionsRequest> deleteRequests = new ArrayList<DeleteAssignedTargetingOptionsRequest>(); // Add browser assigned targeting option IDs to delete request list. deleteRequests.add(new DeleteAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_BROWSER") .setAssignedTargetingOptionIds(delete-browser-assigned-targeting-ids)); // Add device make or model assigned targeting option IDs to delete request list. deleteRequests.add(new DeleteAssignedTargetingOptionsRequest() .setTargetingType("TARGETING_TYPE_DEVICE_MAKE_MODEL") .setAssignedTargetingOptionIds( delete-device-make-model-assigned-targeting-ids)); // Set delete requests in edit request. requestContent.setDeleteRequests(deleteRequests); // Build create request list. ArrayList<CreateAssignedTargetingOptionsRequest> createRequests = new ArrayList<CreateAssignedTargetingOptionsRequest>(); // Create browser assigned targeting option create request. CreateAssignedTargetingOptionsRequest createBrowserTargetingRequest = new CreateAssignedTargetingOptionsRequest(); createBrowserTargetingRequest.setTargetingType("TARGETING_TYPE_BROWSER"); // Create and set list of browser assigned targeting options. ArrayList<AssignedTargetingOption> createBrowserAssignedTargetingOptions = new ArrayList<AssignedTargetingOption>(); for (String targetingOptionId : create-browser-assigned-targeting-ids) { createBrowserAssignedTargetingOptions.add(new AssignedTargetingOption() .setBrowserDetails( new BrowserAssignedTargetingOptionDetails() .setTargetingOptionId(targetingOptionId))); } createBrowserTargetingRequest .setAssignedTargetingOptions(createBrowserAssignedTargetingOptions); // Add browser assigned targeting options to list of create requests. createRequests.add(createBrowserTargetingRequest); // Set create requests in edit request. requestContent.setCreateRequests(createRequests); // Configure the bulk edit request. LineItems.BulkEditAssignedTargetingOptions request = service.advertisers().lineItems() .bulkEditAssignedTargetingOptions( advertiser-id, requestContent); // Execute bulk edit request. BulkEditAssignedTargetingOptionsResponse response = request.execute(); // Check if any line items updated successfully. if (response.getUpdatedLineItemIds() == null || response.getUpdatedLineItemIds().isEmpty()) { System.out.println("No line items were updated successfully."); } else { System.out.printf( "Targeting configurations for the following line item IDs were updated: %s.\n", Arrays.toString(response.getUpdatedLineItemIds().toArray())); } // Check if any line items failed to update. if (response.getFailedLineItemIds() == null || response.getFailedLineItemIds().isEmpty()) { System.out.println("No line items failed to update."); } else { // Print the line items that failed to update. System.out.printf( "Targeting configurations for the following line item IDs failed to update: %s.\n", Arrays.toString(response.getFailedLineItemIds().toArray())); // Print errors thrown for failed updates. System.out.println("The failed updates were caused by the following errors:"); for (Status error : response.getErrors()) { System.out.printf("Error Code: %s, Message: %s\n", error.getCode(), error.getMessage()); } }
Python
# Build assigned targeting option objects to create. createBrowserAssignedTargetingOptions = [] for targeting_id in create-browser-assigned-targeting-ids: createBrowserAssignedTargetingOptions.append( {'browserDetails': {'targetingOptionId': targeting_id}} ) # Create a bulk edit request. bulk_edit_line_item_request = { 'lineItemIds': line-item-ids, 'deleteRequests': [ { 'targetingType': 'TARGETING_TYPE_BROWSER', 'assignedTargetingOptionIds': delete-browser-assigned-targeting-ids }, { 'targetingType': 'TARGETING_TYPE_DEVICE_MAKE_MODEL', 'assignedTargetingOptionIds': delete-device-make-model-assigned-targeting-ids } ], 'createRequests': [ { 'targetingType': 'TARGETING_TYPE_BROWSER', 'assignedTargetingOptions': createBrowserAssignedTargetingOptions } ] } # Edit the line item targeting. response = service.advertisers().lineItems()\ .bulkEditAssignedTargetingOptions( advertiserId=advertiser-id, body=bulk_edit_line_item_request ).execute() # Print successfully updated line items. if 'updatedLineItemIds' not in response: print("No line items were updated successfully.") else: print("Targeting configurations for the following line item IDs were updated: %s" % response['updatedLineItemIds']) # Print line items that failed to update. if 'failedLineItemIds' not in response: print("No line items failed to update.") else: print("Targeting configurations for the following line item IDs failed to update: %s" % response['failedLineItemIds']) if 'errors' in response: print("The failed updates were caused by the following errors:") for error in response["errors"]: print("Error code: %s, Message: %s" % (error["code"], error["message"]))
PHP
// Create delete request list. $deleteRequests = array(); // Create and add browser assigned targeting option IDs to delete request list. $deleteBrowserTargetingRequest = new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest(); $deleteBrowserTargetingRequest->setTargetingType( "TARGETING_TYPE_BROWSER" ); $deleteBrowserTargetingRequest->setAssignedTargetingOptionIds( delete-browser-assigned-targeting-ids ); $deleteRequests[] = $deleteBrowserTargetingRequest; // Create and add device assigned targeting option IDs to delete request list. $deleteDeviceTargetingRequest = new Google_Service_DisplayVideo_DeleteAssignedTargetingOptionsRequest(); $deleteDeviceTargetingRequest->setTargetingType( "TARGETING_TYPE_DEVICE_MAKE_MODEL" ); $deleteDeviceTargetingRequest->setAssignedTargetingOptionIds( delete-device-make-model-assigned-targeting-ids ); $deleteRequests[] = $deleteDeviceTargetingRequest; // Create create request list. $createRequests = array(); // Create and populate list of browser assigned targetion options to create. $createBrowserAssignedTargetingOptions = array(); foreach (create-browser-assigned-targeting-ids as $optionId) { $option = new Google_Service_DisplayVideo_AssignedTargetingOption(); $details = new Google_Service_DisplayVideo_BrowserAssignedTargetingOptionDetails(); $details->setTargetingOptionId($optionId); $option->setBrowserDetails($details); $createBrowserAssignedTargetingOptions[] = $option; } // Create and add browser assigned targeting option create request to create // request list. $createBrowserTargetingRequest = new Google_Service_DisplayVideo_CreateAssignedTargetingOptionsRequest(); $createBrowserTargetingRequest->setTargetingType( "TARGETING_TYPE_BROWSER" ); $createBrowserTargetingRequest->setAssignedTargetingOptions( $createBrowserAssignedTargetingOptions ); $createRequests[] = $createBrowserTargetingRequest; // Create a bulk edit request and assign create and delete request lists. $body = new Google_Service_DisplayVideo_BulkEditAssignedTargetingOptionsRequest(); $body->setLineItemIds(line-item-ids); $body->setCreateRequests($createRequests); $body->setDeleteRequests($deleteRequests); // Call the API, editing the assigned targeting options for the identified // line item. $response = $service ->advertisers_lineItems ->bulkEditAssignedTargetingOptions( advertiser-id, $body ); // Print successfully updated line items. if (!empty($response->getUpdatedLineItemIds())) { printf('Targeting configurations for the following line item IDs were updated:\n'); foreach ($response->getUpdatedLineItemIds() as $id) { printf('%s\n', $id); } } else { print('No line items were updated successfully.\n'); } // Print line items that failed to update. if (!empty($response->getFailedLineItemIds())) { print('Targeting configurations for the following line item IDs failed to update:\n'); foreach ($response->getFailedLineItemIds() as $id) { printf('%s\n', $id); } print('The failed updates were caused by the following errors:\n'); foreach ($response->getErrors() as $error) { printf('Error Code: %s, Message: %s\n', $error->getCode(), $error->getMessage()); } } else { print('No line items failed to update.\n'); }