تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

REST Resource: customers.adsDataLinks

المرجع: AdsDataLink
- تمثيل JSON
الكيان
- تمثيل JSON
EntityType
النظام الأساسي
المقياس
GmpexportScope
الطُرق

المورد: AdsDataLink

تمثّل رابط بيانات الإعلانات.

تمثيل JSON

تمثيل 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,
  "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 بشكلٍ فريد. يحتوي على النموذج عملاء/[customerId]/adsDataLinks/[resource_id]. ينشئ الخادم رقم تعريف المورد.
`linkedEntity`	`object (Entity)` تم ربط الكيان من خلال AdsDataLink هذا.
`parentEntity`	`object (Entity)` الكيان الرئيسي ذو الصلة، إن وجد. إذا كان الكيان المرتبط هو حملة على "إعلانات Google"، سيحتوي هذا الحقل على عميل "إعلانات Google" المقابل الذي تنتمي إليه الحملة.
`childEntities[]`	`object (Entity)` الكيانات الفرعية ذات الصلة، إن وجدت. إذا كان الكيان المرتبط هو عميل "إعلانات Google" يتوافق مع رابط مدير العملاء، ستحتوي الكيانات الفرعية على مجموعة موسّعة بالكامل من عملاء "إعلانات Google" مع البيانات التي تم استيرادها إلى Ads Data Hub من خلال هذا الرابط.
`platform`	`enum (Platform)` النظام الأساسي لعرض الإعلانات المرتبط بالكيان المرتبط.
`customerLink`	`object (CustomerLink)` رابط العميل الذي يمكن الوصول من خلاله إلى البيانات المرتبطة. لا تتم تعبئة سوى الاسم والرقم التعريفي للعميل وdisplayName.
`status`	`enum (LinkStatus)` حالة رابط البيانات.
`createTime`	`string (Timestamp format)` الوقت الذي تم فيه إنشاء الرابط طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: `"2014-10-02T15:01:23Z"` و`"2014-10-02T15:01:23.045123456Z"`.
`updateTime`	`string (Timestamp format)` وقت آخر تعديل لحالة الرابط. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة نانو ثانية وما يصل إلى تسعة أرقام كسور. أمثلة: `"2014-10-02T15:01:23Z"` و`"2014-10-02T15:01:23.045123456Z"`.
`vendorClientId`	`string` معرّف العميل للمورّد، إن توفّر.
`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)` رقم تعريف الكيان. وتعتمد القيمة المذكورة هنا على نوع الكيان.
`displayName`	`string` الاسم المعروض للكيان.
`type`	`enum (EntityType)` نوع الكيان المرتبط.

entityId

string (int64 format)

رقم تعريف الكيان. وتعتمد القيمة المذكورة هنا على نوع الكيان.

displayName

string

الاسم المعروض للكيان.

type

enum (EntityType)

نوع الكيان المرتبط.

نوع الكيان

الكيانات الإعلانية المتاحة.

عمليات التعداد
`ENTITY_TYPE_UNSPECIFIED`	نوع كيان غير محدّد.
`GOOGLE_ADS_CUSTOMER`	أحد عملاء "إعلانات Google". يتوافق `entityId` مع [Customer.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#customer] في Google Ads API.
`GOOGLE_ADS_CAMPAIGN`	حملة على "إعلانات Google". يتطابق `entityId` مع [Campaign.id][https://developers.google.com/google-ads/api/reference/rpc/google.ads.googleads.v0.resources#campaign] في Google Ads API.
`GMP_CM_ACCOUNT`	حساب مدير الحملة على "منصة Google للتسويق". تتوافق العلامة `entityId` مع [Accounts.id][https://developers.google.com/doubleclick-advertisers/v3.3/accounts]
`GMP_CM_FLOODLIGHT`	حساب Floodlight في "مدير الحملة". تتوافق العلامة `entityId` مع [FloodlightConfigurations.accountId][https://developers.google.com/doubleclick-advertisers/v3.3/floodlightConfigurations]
`GMP_DV360_PARTNER`	رقم تعريف شريك "مساحة العرض والفيديو 360". `entityId` هو رقم تعريف شريك"مساحة العرض والفيديو 360".
`GMP_DV360_ADVERTISER`	الرقم التعريفي للمعلِن في "مساحة العرض والفيديو 360". `entityId` هو الرقم التعريفي للمعلِن في"مساحة العرض والفيديو 360".
`GMP_DV360_ORDER`	رقم تعريف طلب "مساحة العرض والفيديو 360". `entityId` هو معرّف طلب في"مساحة العرض والفيديو 360".
`GMP_DV360_LINE_ITEM`	رقم تعريف العنصر في "مساحة العرض والفيديو 360". `entityId` هو معرّف عنصر في "مساحة العرض والفيديو 360".
`YT_RESERVE_ORDER`	معرّف الطلب في YouTube Reserve. يتطابق `entityId` مع [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] في "مدير إعلانات Google".
`YT_RESERVE_LINE_ITEM`	عنصر YouTube Reserve. يتطابق `entityId` مع [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] في"مدير إعلانات Google".
`VENDOR_CLIENT_ID_REGISTRATION`	معرّف العميل للمورّد الذي يتم تسجيله يدويًا من قِبل مورّد تقنية الإعلان التابع لجهة خارجية من أجل توفير قياسات الجهة الخارجية.
`GOOGLE_AD_MANAGER_ORDER`	مُعرّف طلب "مدير إعلانات Google" يتطابق `entityId` مع [Order.id][https://developers.google.com/ad-manager/api/reference/v201902/OrderService.Order#id] في "مدير إعلانات Google".
`GOOGLE_AD_MANAGER_LINE_ITEM`	عنصر في "مدير إعلانات Google". يتطابق `entityId` مع [LineItem.id][https://developers.google.com/ad-manager/api/reference/v201902/LineItemService.LineItem#id] في"مدير إعلانات Google".

النظام الأساسي

المنصّات المتوافقة لعرض الإعلانات

عمليات التعداد
`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`	المقياس المقابل لإمكانية العرض، حيث يكون العميل هو الناشر/مقدّم المحتوى.

نطاق Gmpتصدير

الأنواع المختلفة من البيانات التي يمكن تصديرها لروابط "منصة Google للتسويق".

عمليات التعداد
`GMP_EXPORT_SCOPE_UNSPECIFIED`	نطاق غير محدّد.
`GMP_EXPORT_SCOPE_YT_TRUEVIEW`	يجب تصدير بيانات TrueView على YouTube في "مساحة العرض والفيديو 360".
`GMP_EXPORT_SCOPE_DT`	يجب تصدير بيانات DT.

الطُرق
`batchApprove`	الموافقة على قائمة روابط بيانات في انتظار المراجعة.
`batchReject`	رفض قائمة روابط بيانات في انتظار المراجعة.
`list`	يسرد روابط بين العميل المحدّد والكيانات الإعلانية الأخرى في Google.

REST Resource: customers.adsDataLinks

المورد: AdsDataLink

الكيان

نوع الكيان

النظام الأساسي

المقياس

نطاق Gmpتصدير

الطُرق

`batchApprove`

`batchReject`

`list`