Starting
September 8, 2025, every new line item will need to declare whether or not they will serve Eurpoean Union (EU) political ads. Display & Video 360 API and SDF uploads that don't provide declarations will fail. See our
deprecations page for more details on how to update your integration to make this declaration.
Method: inventorySources.editInventorySourceReadWriteAccessors
Stay organized with collections
Save and categorize content based on your preferences.
Edits read/write accessors of an inventory source. Returns the updated readWriteAccessors
for the inventory source.
HTTP request
POST https://displayvideo.googleapis.com/v4/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors
The URL uses gRPC Transcoding syntax.
Path parameters
Parameters |
inventorySourceId |
string (int64 format)
Required. The ID of inventory source to update.
|
Request body
The request body contains data with the following structure:
JSON representation |
{
"partnerId": string,
// Union field accessors_change can be only one of the following:
"assignPartner": boolean,
"advertisersUpdate": {
object (AdvertisersUpdate )
}
// End of list of possible types for union field accessors_change .
} |
Fields |
partnerId |
string (int64 format)
Required. The partner context by which the accessors change is being made.
|
Union field accessors_change . The change to the read/write accessors of the inventory source. accessors_change can be only one of the following: |
assignPartner |
boolean
Set the partner context as read/write accessor of the inventory source. This will remove all other current read/write advertiser accessors.
|
advertisersUpdate |
object (AdvertisersUpdate )
The advertisers to add or remove from the list of advertisers that have read/write access to the inventory source. This change will remove an existing partner read/write accessor.
|
Response body
If successful, the response body contains an instance of InventorySourceAccessors
.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/display-video
For more information, see the OAuth 2.0 Overview.
AdvertisersUpdate
Update to the list of advertisers with read/write access to the inventory source.
JSON representation |
{
"addedAdvertisers": [
string
],
"removedAdvertisers": [
string
]
} |
Fields |
addedAdvertisers[] |
string (int64 format)
The advertisers to add.
|
removedAdvertisers[] |
string (int64 format)
The advertisers to remove.
|
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-03-27 UTC.
[null,null,["Last updated 2025-03-27 UTC."],[],["The Display & Video 360 API v4 (beta) allows editing read/write accessors for inventory sources via a POST request to a specific URL. The request requires the `inventorySourceId` as a path parameter and a JSON body specifying the `partnerId`. Accessors can be changed by either assigning a partner read/write access or updating specific advertisers' access via `addedAdvertisers` and `removedAdvertisers` fields. The response will provide updated `InventorySourceAccessors` and `OAuth` scope is required.\n"],null,["# Method: inventorySources.editInventorySourceReadWriteAccessors\n\n- [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- [Authorization scopes](#body.aspect)\n- [AdvertisersUpdate](#AdvertisersUpdate)\n - [JSON representation](#AdvertisersUpdate.SCHEMA_REPRESENTATION)\n- [Try it!](#try-it)\n\nEdits read/write accessors of an inventory source. Returns the updated [readWriteAccessors](/display-video/api/reference/rest/v4/inventorySources#InventorySource.FIELDS.read_write_accessors) for the inventory source.\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/inventorySources/{inventorySourceId}:editInventorySourceReadWriteAccessors`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------|\n| `inventorySourceId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of inventory source to update. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"partnerId\": string, // Union field `accessors_change` can be only one of the following: \"assignPartner\": boolean, \"advertisersUpdate\": { object (/display-video/api/reference/rest/v4/inventorySources/editInventorySourceReadWriteAccessors#AdvertisersUpdate) } // End of list of possible types for union field `accessors_change`. } ``` |\n\n| Fields ||\n|---------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `partnerId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The partner context by which the accessors change is being made. |\n| Union field `accessors_change`. The change to the read/write accessors of the inventory source. `accessors_change` can be only one of the following: ||\n| `assignPartner` | `boolean` Set the partner context as read/write accessor of the inventory source. This will remove all other current read/write advertiser accessors. |\n| `advertisersUpdate` | `object (`[AdvertisersUpdate](/display-video/api/reference/rest/v4/inventorySources/editInventorySourceReadWriteAccessors#AdvertisersUpdate)`)` The advertisers to add or remove from the list of advertisers that have read/write access to the inventory source. This change will remove an existing partner read/write accessor. |\n\n### Response body\n\nIf successful, the response body contains an instance of [InventorySourceAccessors](/display-video/api/reference/rest/v4/inventorySources#InventorySourceAccessors).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2).\n\nAdvertisersUpdate\n-----------------\n\nUpdate to the list of advertisers with read/write access to the inventory source.\n\n| JSON representation |\n|------------------------------------------------------------------------------|\n| ``` { \"addedAdvertisers\": [ string ], \"removedAdvertisers\": [ string ] } ``` |\n\n| Fields ||\n|------------------------|----------------------------------------------------------------------------------------------------------------|\n| `addedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to add. |\n| `removedAdvertisers[]` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` The advertisers to remove. |"]]