Method: networks.placements.batchUpdate
Stay organized with collections
Save and categorize content based on your preferences.
API to batch update Placement objects.
HTTP request
POST https://admanager.googleapis.com/v1/{parent}/placements:batchUpdate
Path parameters
| Parameters |
parent |
string
Required. The parent resource where Placements will be updated. Format: networks/{networkCode} The parent field in the UpdatePlacementsRequest must match this field.
|
Request body
The request body contains data with the following structure:
| Fields |
requests[] |
object (UpdatePlacementRequest)
Required. The Placement objects to update. A maximum of 100 objects can be updated in a batch.
|
Response body
Response object for placements.batchUpdate method.
If successful, the response body contains data with the following structure:
| JSON representation |
{
"placements": [
{
object (Placement)
}
]
} |
| Fields |
placements[] |
object (Placement)
The Placement objects updated.
|
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/admanager
For more information, see the OAuth 2.0 Overview.
UpdatePlacementRequest
Request object for placements.patch method.
| JSON representation |
{
"placement": {
object (Placement)
},
"updateMask": string
} |
| Fields |
placement |
object (Placement)
Required. The Placement to update. The Placement's name is used to identify the Placement to update. Format: networks/{networkCode}/placements/{placementId}
|
updateMask |
string (FieldMask format)
Required. The list of fields to update. This is a comma-separated list of fully qualified names of fields. Example: "user.displayName,photo".
|
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-05 UTC.
[null,null,["Last updated 2025-09-05 UTC."],[],[],null,["- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.BatchUpdatePlacementsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [UpdatePlacementRequest](#UpdatePlacementRequest)\n - [JSON representation](#UpdatePlacementRequest.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nAPI to batch update `Placement` objects.\n\nHTTP request\n\n`POST https://admanager.googleapis.com/v1/{parent}/placements:batchUpdate`\n\nPath parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource where `Placements` will be updated. Format: `networks/{networkCode}` The parent field in the UpdatePlacementsRequest must match this field. |\n\nRequest body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"requests\": [ { object (/ad-manager/api/beta/reference/rest/v1/networks.placements/batchUpdate#UpdatePlacementRequest) } ] } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requests[]` | `object (`[UpdatePlacementRequest](/ad-manager/api/beta/reference/rest/v1/networks.placements/batchUpdate#UpdatePlacementRequest)`)` Required. The `Placement` objects to update. A maximum of 100 objects can be updated in a batch. |\n\nResponse body Response object for `placements.batchUpdate` method.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------|\n| ``` { \"placements\": [ { object (/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement) } ] } ``` |\n\n| Fields ||\n|----------------|---------------------------------------------------------------------------------------------------------------------------------|\n| `placements[]` | `object (`[Placement](/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement)`)` The `Placement` objects updated. |\n\nAuthorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/admanager`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nUpdatePlacementRequest Request object for `placements.patch` method.\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"placement\": { object (/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement) }, \"updateMask\": string } ``` |\n\n| Fields ||\n|--------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `placement` | `object (`[Placement](/ad-manager/api/beta/reference/rest/v1/networks.placements#Placement)`)` Required. The `Placement` to update. The `Placement`'s name is used to identify the `Placement` to update. Format: `networks/{networkCode}/placements/{placementId}` |\n| `updateMask` | `string (`[FieldMask](https://protobuf.dev/reference/protobuf/google.protobuf/#field-mask)` format)` Required. The list of fields to update. This is a comma-separated list of fully qualified names of fields. Example: `\"user.displayName,photo\"`. |"]]
