REST Resource: customers.adsDataLinks

• リソース: AdsDataLink
  • JSON 表現
• Entity
  • JSON 表現
• EntityType
• Platform
• 指標
• GmpExportScope
• Methods

リソース: AdsDataLink

広告データリンクを表します。

JSON 表現
{ "name": string, "linkedEntity": { object (Entity) }, "parentEntity": { object (Entity) }, "childEntities": [ { object (Entity) } ], "platform": enum (Platform), "customerLink": { object (CustomerLink) }, "status": enum (LinkStatus), "createTime": string, "updateTime": string, "vendorClientId": string, "metrics": [ enum (Metric) ], "gmpExportScopes": [ enum (GmpExportScope) ] }

フィールド
name	string AdsDataLink リソースを一意に識別する名前。形式は customer/[お客様 ID]/adsDataLinks/[resource_id] です。リソース ID はサーバーによって生成されます。
linkedEntity	object (Entity) この AdsDataLink を介してリンクされたエンティティ。
parentEntity	object (Entity) 関連する親エンティティ（ある場合）。リンクされたエンティティが Google 広告の広告キャンペーンである場合、このフィールドには、キャンペーンが属する Google 広告のお客様が含まれます。
childEntities[]	object (Entity) 関連する子エンティティ（ある場合）。リンクされたエンティティが Google 広告の顧客であり、顧客とマネージャーのリンクに対応している場合、childEntity には、このリンクを通じて Ads Data Hub にインポートされたデータを持つ Google 広告の顧客が完全に拡張されます。
platform	enum (Platform) リンクされたエンティティに関連付けられた広告プラットフォーム。
customerLink	object (CustomerLink) リンクされたデータにアクセスするための顧客リンク。名前、お客様 ID、displayName のみが入力されます。
status	enum (LinkStatus) データリンクのステータス。
createTime	string (Timestamp format) リンクが作成された時刻。 RFC3339 UTC の Zulu 形式のタイムスタンプ。ナノ秒単位で、小数点以下は 9 桁までとなります。（例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"）。
updateTime	string (Timestamp format) リンク ステータスの最終更新日時。 RFC3339 UTC の Zulu 形式のタイムスタンプ。ナノ秒単位で、小数点以下は 9 桁までとなります。（例: "2014-10-02T15:01:23Z"、"2014-10-02T15:01:23.045123456Z"）。
vendorClientId	string ベンダーのクライアント ID（存在する場合）。
metrics[]	enum (Metric) このデータリンクを介してアクセスできる指標。空の場合、指標の制限は適用されません。現在、このフィールドは単一値であり、リンク エンティティ タイプが GOOGLE_ADS_CAMPAIGN または YT_RESERVE_LINE_ITEM の場合にのみサポートされます。
gmpExportScopes[]	enum (GmpExportScope) ディスプレイ &ビデオ 360 リンク用にエクスポートされるデータの種類。プラットフォームが GOOGLE_MARKETING_PLATFORM の場合にのみ入力されます。空の場合、指定されず、任意の組み合わせを使用できます。

エンティティ

Ads Data Hub 顧客にリンクできる広告エンティティを表します。

JSON 表現
{ "entityId": string, "displayName": string, "type": enum (EntityType) }

フィールド
entityId	string (int64 format) エンティティ ID。ここに表示される値は、エンティティ タイプによって異なります。
displayName	string エンティティの表示名。
type	enum (EntityType) リンクされたエンティティのタイプ。

EntityType

サポートされている広告エンティティ。

列挙型
ENTITY_TYPE_UNSPECIFIED	エンティティ タイプが指定されていません。
GOOGLE_ADS_CUSTOMER	Google 広告のお客様entityId は、Google Ads API の Customer.id に対応します。
GOOGLE_ADS_CAMPAIGN	Google 広告の広告キャンペーン。entityId は、Google Ads API の Campaign.id に対応します。
GMP_CM_ACCOUNT	キャンペーン マネージャー 360 アカウントentityIdは、キャンペーン マネージャー 360 API の Accounts.id に対応しています。
GMP_CM_FLOODLIGHT	キャンペーン マネージャー 360 の Floodlight アカウント。entityIdは、キャンペーン マネージャー 360 API の FloodlightConfigurations.accountId に対応しています。
GMP_DV360_PARTNER	ディスプレイ &ビデオ 360 のパートナー ID です。entityIdはディスプレイ &ビデオ 360 のパートナー ID です。
GMP_DV360_ADVERTISER	ディスプレイ &ビデオ 360 の広告主 ID。entityIdは、ディスプレイ &ビデオ 360 の広告主 ID です。
GMP_DV360_ORDER	ディスプレイ &ビデオ 360 オーダー ID。entityId は、ディスプレイ &ビデオ 360 オーダー ID です。
GMP_DV360_LINE_ITEM	ディスプレイ &ビデオ 360 の広告申込情報 IDentityId は、ディスプレイ &ビデオ 360 の広告申込情報 ID です。
YT_RESERVE_ORDER	YouTube Reserve の注文 ID。entityId は、Google アド マネージャー API の Order.id に対応しています。
YT_RESERVE_LINE_ITEM	YouTube Reserve の広告申込情報。entityId は、Google アド マネージャー API の LineItem.id に対応しています。
VENDOR_CLIENT_ID_REGISTRATION	第三者による測定を可能にするために、第三者広告技術ベンダーが手動で登録するベンダー クライアント ID。
GOOGLE_AD_MANAGER_ORDER	Google アド マネージャーオーダー ID。entityId は、Google アド マネージャー API の Order.id に対応しています。
GOOGLE_AD_MANAGER_LINE_ITEM	Google アド マネージャーの広告申込情報。entityId は、Google アド マネージャー API の LineItem.id に対応しています。

プラットフォーム

サポートされている広告プラットフォーム。

列挙型
PLATFORM_UNSPECIFIED	不明なプラットフォーム。
GOOGLE_ADS	エンティティが Google 広告に関連付けられています。
GOOGLE_MARKETING_PLATFORM	エンティティが Google マーケティング プラットフォームに関連付けられている。
YOUTUBE_RESERVE	エンティティが YouTube Reserve に関連付けられている。
GOOGLE_AD_MANAGER	エンティティが Google アド マネージャーに関連付けられている。
FREEWHEEL	このエンティティは FreeWheel に関連付けられています。

指標

広告データリンクで表示できる指標。

列挙型
METRIC_UNSPECIFIED	指標の指定なし。
BRAND_LIFT	ブランド効果測定に対応する指標。
BRAND_SAFETY	ブランド保護に対応する指標。
REACH	リーチに対応する指標（お客様が広告主の場合）。
VIEWABILITY	視認性に対応する指標（お客様が広告主の場合）。
PUBLISHER_REACH	「リーチ」に対応する指標です。顧客はパブリッシャーやコンテンツ プロバイダになります。
PUBLISHER_VIEWABILITY	視認性に対応する指標。顧客はパブリッシャーまたはコンテンツ プロバイダになります。

GmpExportScope

GMP リンク向けにエクスポートできるさまざまな種類のデータです。

列挙型
GMP_EXPORT_SCOPE_UNSPECIFIED	スコープが指定されていません。
GMP_EXPORT_SCOPE_YT_TRUEVIEW	ディスプレイ &ビデオ 360 の YouTube TrueView データをエクスポートする必要があります。
GMP_EXPORT_SCOPE_DT	Data Transfer データをエクスポートする必要があります。

Methods
batchApprove	保留中の広告データリンクのリストを承認します。
batchReject	保留中の広告データリンクのリストを拒否する。
list	指定した顧客と他の Google 広告エンティティとの間のリンクを一覧表示します。