The Data Manager API is in closed beta. To express interest in joining the closed beta, fill out
this form.
Destination
透過集合功能整理內容
你可以依據偏好儲存及分類內容。
要將資料傳送至哪個 Google 產品。例如 Google Ads 帳戶。
欄位 |
reference |
string
(選用步驟) 這個 Destination 資源的 ID,在要求中必須是唯一的。在 IngestEventsRequest 中參照這個 Destination 時使用。
|
loginAccount |
object (ProductAccount )
(選用步驟) 用於發出這項 API 呼叫的帳戶。如要新增或移除 operatingAccount 中的資料,這個 loginAccount 必須具備 operatingAccount 的寫入權限。舉例來說,operatingAccount 的管理員帳戶,或是已連結至 operatingAccount 的帳戶。
|
linkedAccount |
object (ProductAccount )
(選用步驟) 通話使用者loginAccount 可透過已建立的帳戶連結存取的帳戶。舉例來說,資料合作夥伴的 loginAccount 可能可以存取客戶的 linkedAccount 。合作夥伴可能會使用這個欄位,將資料從 linkedAccount 傳送至另一個 operatingAccount 。
|
operatingAccount |
object (ProductAccount )
必要欄位。要傳送資料至哪個帳戶,或是要從哪個帳戶移除資料。
|
productDestinationId |
string
必要欄位。要擷取資料的產品帳戶物件。例如 Google Ads 目標對象 ID 或 Display & Video 360 目標對象 ID。
|
ProductAccount
JSON 表示法 |
{
"product": enum (Product ),
"accountId": string
} |
欄位 |
product |
enum (Product )
必要欄位。帳戶所屬的產品。例如 GOOGLE_ADS 。
|
accountId |
string
必要欄位。帳戶的 ID。例如 Google Ads 帳戶 ID。
|
產品
代表特定 Google 產品。用於尋找帳戶和目的地。
列舉 |
PRODUCT_UNSPECIFIED |
未指明產品。請一律不使用這個值。 |
GOOGLE_ADS |
Google Ads。 |
DISPLAY_VIDEO_PARTNER |
Display & Video 360 合作夥伴。 |
DISPLAY_VIDEO_ADVERTISER |
Display & Video 360 廣告主。 |
DATA_PARTNER |
資料合作夥伴。 |
除非另有註明,否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權,程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間:2025-07-25 (世界標準時間)。
[null,null,["上次更新時間:2025-07-25 (世界標準時間)。"],[],[],null,["# Destination\n\n- [JSON representation](#SCHEMA_REPRESENTATION)\n- [ProductAccount](#ProductAccount)\n - [JSON representation](#ProductAccount.SCHEMA_REPRESENTATION)\n- [Product](#Product)\n\nThe Google product you're sending data to. For example, a Google Ads account.\n\n| JSON representation |\n|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"reference\": string, \"loginAccount\": { object (/data-manager/api/reference/rest/v1/Destination#ProductAccount) }, \"linkedAccount\": { object (/data-manager/api/reference/rest/v1/Destination#ProductAccount) }, \"operatingAccount\": { object (/data-manager/api/reference/rest/v1/Destination#ProductAccount) }, \"productDestinationId\": string } ``` |\n\n| Fields ||\n|------------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `reference` | `string` Optional. ID for this `Destination` resource, unique within the request. Use to reference this `Destination` in the `IngestEventsRequest`. |\n| `loginAccount` | `object (`[ProductAccount](/data-manager/api/reference/rest/v1/Destination#ProductAccount)`)` Optional. The account used to make this API call. To add or remove data from the [`operatingAccount`](/data-manager/api/reference/rest/v1/Destination#FIELDS.operating_account), this `loginAccount` must have write access to the `operatingAccount`. For example, a manager account of the `operatingAccount`, or an account with an established link to the `operatingAccount`. |\n| `linkedAccount` | `object (`[ProductAccount](/data-manager/api/reference/rest/v1/Destination#ProductAccount)`)` Optional. An account that the calling user's [`loginAccount`](/data-manager/api/reference/rest/v1/Destination#FIELDS.login_account) has access to, through an established account link. For example, a data partner's `loginAccount` might have access to a client's `linkedAccount`. The partner might use this field to send data from the `linkedAccount` to another [`operatingAccount`](/data-manager/api/reference/rest/v1/Destination#FIELDS.operating_account). |\n| `operatingAccount` | `object (`[ProductAccount](/data-manager/api/reference/rest/v1/Destination#ProductAccount)`)` Required. The account to send the data to or remove the data from. |\n| `productDestinationId` | `string` Required. The object within the product account to ingest into. For example, a Google Ads audience ID or a Display \\& Video 360 audience ID. |\n\nProductAccount\n--------------\n\nRepresents a specific account.\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------|\n| ``` { \"product\": enum (/data-manager/api/reference/rest/v1/Destination#Product), \"accountId\": string } ``` |\n\n| Fields ||\n|-------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `product` | `enum (`[Product](/data-manager/api/reference/rest/v1/Destination#Product)`)` Required. The product the account belongs to. For example, `GOOGLE_ADS`. |\n| `accountId` | `string` Required. The ID of the account. For example, your Google Ads account ID. |\n\nProduct\n-------\n\nRepresents a specific Google product. Used to locate accounts and destinations.\n\n| Enums ||\n|----------------------------|--------------------------------------------|\n| `PRODUCT_UNSPECIFIED` | Unspecified product. Should never be used. |\n| `GOOGLE_ADS` | Google Ads. |\n| `DISPLAY_VIDEO_PARTNER` | Display \\& Video 360 partner. |\n| `DISPLAY_VIDEO_ADVERTISER` | Display \\& Video 360 advertiser. |\n| `DATA_PARTNER` | Data Partner. |"]]