AdsApp.PlacementOperation
Stay organized with collections
Save and categorize content based on your preferences.
An operation representing creation of a new placement. Calling any
method
( getErrors
, getResult
, or isSuccessful
)
will cause the operation to execute and create the placement. To
make the script more efficient, it's recommended that you store the
operations in an array and only call these methods once you've constructed
all the operations you want. Methods:
getErrors()
Returns an empty array if the operation was successful, otherwise returns
the list of errors encountered when trying to create the Placement. Return values:
getResult()
Returns the newly created Placement, or null
if
the operation was unsuccessful. Return values:
isSuccessful()
Returns true
if the operation was successful. Return values:
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License
, and code samples are licensed under the Apache 2.0 License
. For details, see the Google Developers Site Policies
. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-09-03 UTC.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-09-03 UTC."],[[["\u003cp\u003e\u003ccode\u003ePlacementOperation\u003c/code\u003e represents the creation of a new placement in Google Ads.\u003c/p\u003e\n"],["\u003cp\u003eCalling \u003ccode\u003egetErrors\u003c/code\u003e, \u003ccode\u003egetResult\u003c/code\u003e, or \u003ccode\u003eisSuccessful\u003c/code\u003e executes the operation and creates the placement.\u003c/p\u003e\n"],["\u003cp\u003eFor efficiency, store operations in an array and execute them together.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003egetErrors\u003c/code\u003e, \u003ccode\u003egetResult\u003c/code\u003e, and \u003ccode\u003eisSuccessful\u003c/code\u003e provide information on the operation's success and results.\u003c/p\u003e\n"]]],[],null,["# AdsApp.PlacementOperation\n\nAn operation representing creation of a new placement. Calling any method ([getErrors](/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation#getErrors), [getResult](/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation#getResult), or [isSuccessful](/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation#isSuccessful)) will cause the operation to execute and create the placement. To make the script more efficient, it's recommended that you store the operations in an array and only call these methods once you've constructed all the operations you want.\n\n### Methods:\n\n| Member | Type | Description |\n|---------------------------------|--------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------|\n| [getErrors()](#getErrors) | `String[]` | Returns an empty array if the operation was successful, otherwise returns the list of errors encountered when trying to create the Placement. |\n| [getResult()](#getResult) | [AdsApp.Placement](/google-ads/scripts/docs/reference/adsapp/adsapp_placement) | Returns the newly created Placement, or `null` if the operation was unsuccessful. |\n| [isSuccessful()](#isSuccessful) | `boolean` | Returns `true` if the operation was successful. |\n\n`getErrors()`\n-------------\n\nReturns an empty array if the operation was successful, otherwise returns the list of errors encountered when trying to create the Placement.\n\n### Return values:\n\n| Type | Description |\n|------------|--------------------------------------------------------------------------------------------------------------------------------|\n| `String[]` | The errors that occurred during the [PlacementOperation](/google-ads/scripts/docs/reference/adsapp/adsapp_placementoperation). |\n\n`getResult()`\n-------------\n\nReturns the newly created Placement, or `null` if the operation was unsuccessful.\n\n### Return values:\n\n| Type | Description |\n|--------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------|\n| [AdsApp.Placement](/google-ads/scripts/docs/reference/adsapp/adsapp_placement) | The [Placement](/google-ads/scripts/docs/reference/adsapp/adsapp_placement) created by the PlacementOperation. |\n\n`isSuccessful()`\n----------------\n\nReturns `true` if the operation was successful.\n\n### Return values:\n\n| Type | Description |\n|-----------|-----------------------------------------|\n| `boolean` | `true` if the operation was successful. |"]]
