> [!WARNING]
> Display \& Video 360 API v5 is currently in beta.

- [Resource: InventorySource](https://developers.google.com/display-video/api/reference/rest/v5/partners.inventorySources#InventorySource)
  - [JSON representation](https://developers.google.com/display-video/api/reference/rest/v5/partners.inventorySources#InventorySource.SCHEMA_REPRESENTATION)
- [Methods](https://developers.google.com/display-video/api/reference/rest/v5/partners.inventorySources#METHODS_SUMMARY)

## Resource: InventorySource

An inventory source.

| JSON representation |
|---|
| ``` { "name": string, "inventorySourceId": string, "displayName": string, "inventorySourceType": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceType`), "inventorySourceProductType": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceProductType`), "commitment": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceCommitment`), "deliveryMethod": enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceDeliveryMethod`), "dealId": string, "status": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceStatus`) }, "exchange": enum (`https://developers.google.com/display-video/api/reference/rest/v5/Exchange`), "updateTime": string, "rateDetails": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.RateDetails`) }, "publisherName": string, "timeRange": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.TimeRange`) }, "creativeConfigs": [ { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.CreativeConfig`) } ], "guaranteedOrderId": string, "readWriteAccessors": { object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceAccessors`) }, "readAdvertiserIds": [ string ], "readPartnerIds": [ string ] } ``` |

| Fields ||
|---|---|
| `name` | `string` Output only. The resource name of the inventory source. |
| `inventorySourceId` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The unique ID of the inventory source. Assigned by the system. |
| `displayName` | `string` The display name of the inventory source. Must be UTF-8 encoded with a maximum size of 240 bytes. |
| `inventorySourceType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceType`)`` Denotes the type of the inventory source. |
| `inventorySourceProductType` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceProductType`)`` Output only. The product type of the inventory source, denoting the way through which it sells inventory. |
| `commitment` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceCommitment`)`` Whether the inventory source has a guaranteed or non-guaranteed delivery. |
| `deliveryMethod` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceDeliveryMethod`)`` The delivery method of the inventory source. - For non-guaranteed inventory sources, the only acceptable value is `INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC`. - For guaranteed inventory sources, acceptable values are `INVENTORY_SOURCE_DELIVERY_METHOD_TAG` and `INVENTORY_SOURCE_DELIVERY_METHOD_PROGRAMMATIC`. |
| `dealId` | `string` The ID in the exchange space that uniquely identifies the inventory source. Must be unique across buyers within each exchange but not necessarily unique across exchanges. |
| `status` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceStatus`)`` The status settings of the inventory source. |
| `exchange` | ``enum (`https://developers.google.com/display-video/api/reference/rest/v5/Exchange`)`` The exchange to which the inventory source belongs. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The timestamp when the inventory source was last updated. Assigned by the system. Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `rateDetails` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.RateDetails`)`` Required. The rate details of the inventory source. |
| `publisherName` | `string` The publisher/seller name of the inventory source. |
| `timeRange` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.TimeRange`)`` The time range when this inventory source starts and stops serving. |
| `creativeConfigs[]` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.CreativeConfig`)`` The creative requirements of the inventory source. Not applicable for auction packages. |
| `guaranteedOrderId` | `string` Immutable. The ID of the guaranteed order that this inventory source belongs to. Only applicable when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.FIELDS.commitment` is `INVENTORY_SOURCE_COMMITMENT_GUARANTEED`. |
| `readWriteAccessors` | ``object (`https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.InventorySourceAccessors`)`` The partner or advertisers that have read/write access to the inventory source. Output only when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.FIELDS.commitment` is `INVENTORY_SOURCE_COMMITMENT_GUARANTEED`, in which case the read/write accessors are inherited from the parent guaranteed order. Required when `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.FIELDS.commitment` is `INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED`. If `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.FIELDS.commitment` is `INVENTORY_SOURCE_COMMITMENT_NON_GUARANTEED` and a partner is set in this field, all advertisers under this partner will automatically have read-only access to the inventory source. These advertisers will not be included in `https://developers.google.com/display-video/api/reference/rest/v5/advertisers.inventorySources#InventorySource.FIELDS.read_advertiser_ids`. |
| `readAdvertiserIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The IDs of advertisers with read-only access to the inventory source. |
| `readPartnerIds[]` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. The IDs of partners with read-only access to the inventory source. All advertisers of partners in this field inherit read-only access to the inventory source. |

| ## Methods ||
|---|---|
| ### `https://developers.google.com/display-video/api/reference/rest/v5/partners.inventorySources/get` | Gets an inventory source deal. |
| ### `https://developers.google.com/display-video/api/reference/rest/v5/partners.inventorySources/list` | Lists inventory source deals. |