تنبيه: يتم عرض مستندات واجهة REST API. تستخدم معظم مكتبات العملاء الرسمية خدمة gRPC. يمكنك الاطلاع على مقدمة عن REST للحصول على التفاصيل.

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

AccountLink

تمثيل JSON
AccountLinkStatus
LinkedAccountType
‫ThirdPartyAppAnalyticsLinkIdentifier
- تمثيل JSON

يمثّل ربط مشاركة البيانات بين حساب على "إعلانات Google" وحساب آخر

تمثيل JSON

تمثيل JSON
{ "resourceName": string, "status": enum (`AccountLinkStatus`), "type": enum (`LinkedAccountType`), "accountLinkId": string, // Union field `linked_account` can be only one of the following: "thirdPartyAppAnalytics": { object (`ThirdPartyAppAnalyticsLinkIdentifier`) } // End of list of possible types for union field `linked_account`. }

{
  "resourceName": string,
  "status": enum (AccountLinkStatus),
  "type": enum (LinkedAccountType),
  "accountLinkId": string,

  // Union field linked_account can be only one of the following:
  "thirdPartyAppAnalytics": {
    object (ThirdPartyAppAnalyticsLinkIdentifier)
  }
  // End of list of possible types for union field linked_account.
}

الحقول
`resourceName`	`string` غير قابل للتغيير اسم المورد لرابط الحساب تكون أسماء موارد AccountLink على النحو التالي: `customers/{customerId}/accountLinks/{accountLinkId}`
`status`	`enum (AccountLinkStatus)` حالة الرابط
`type`	`enum (LinkedAccountType)` النتائج فقط. نوع الحساب المرتبط.
`accountLinkId`	`string (int64 format)` النتائج فقط. رقم تعريف الرابط هذا الحقل للقراءة فقط.
حقل الربط `linked_account` حساب مرتبط بحساب "إعلانات Google" هذا يمكن أن يكون `linked_account` واحدًا فقط مما يلي:
`thirdPartyAppAnalytics`	`object (ThirdPartyAppAnalyticsLinkIdentifier)` غير قابل للتغيير رابط إحصاءات التطبيقات التابع لجهة خارجية

AccountLinkStatus

يوضّح هذا القسم الحالات المحتمَلة لرابط بين عميل على "إعلانات Google" وحساب آخر.

عمليات التعداد
`UNSPECIFIED`	غير محدّد
`UNKNOWN`	تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
`ENABLED`	الرابط مفعَّل.
`REMOVED`	تمّت إزالة الرابط أو إيقافه.
`REQUESTED`	تم طلب ربط الحساب الآخر. يمكن الآن لمستخدم في الحساب الآخر الموافقة على الربط من خلال ضبط الحالة على "مفعّل".
`PENDING_APPROVAL`	طلب مستخدم في الحساب الآخر هذا الرابط. يمكن أن يوافق عليها مستخدم في هذا الحساب من خلال ضبط الحالة على "مفعَّل".
`REJECTED`	رفض المشرف الرابط.
`REVOKED`	إلغاء الرابط من قِبل المستخدم الذي طلب الربط

LinkedAccountType

يوضّح أنواع الروابط المحتملة بين عميل "إعلانات Google" وحساب آخر.

عمليات التعداد
`UNSPECIFIED`	غير محدّد
`UNKNOWN`	تُستخدَم لقيمة الإرجاع فقط. يمثّل قيمة غير معروفة في هذا الإصدار.
`THIRD_PARTY_APP_ANALYTICS`	رابط لتقديم بيانات إحصاءات التطبيقات التابعة لجهة خارجية

ThirdPartyAppAnalyticsLinkIdentifier

معرّفات رابط إحصاءات التطبيقات التابع لجهة خارجية

تمثيل JSON
{ "appVendor": enum (`MobileAppVendor`), "appAnalyticsProviderId": string, "appId": string }

الحقول

الحقول
`appVendor`	`enum (MobileAppVendor)` غير قابل للتغيير مورّد التطبيق. يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات التطبيقات التابعة لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.
`appAnalyticsProviderId`	`string (int64 format)` غير قابل للتغيير رقم تعريف مقدّم خدمة تحليلات التطبيقات. يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات التطبيقات التابعة لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.
`appId`	`string` غير قابل للتغيير سلسلة تحدِّد بشكل فريد تطبيقًا جوّالاً تم جمع البيانات منه إلى Google Ads API. بالنسبة إلى نظام التشغيل iOS، سلسلة التعريف هي السلسلة المكونة من 9 أرقام التي تظهر في نهاية عنوان URL الخاص بمتجر التطبيقات (على سبيل المثال، "422689480" لتطبيق Gmail الذي يرتبط برابط App Store‏ https://apps.apple.com/us/app/gmail-email-by-google/id422689480). بالنسبة إلى Android، سلسلة المعرّف هي اسم حزمة التطبيق (على سبيل المثال، "com.google.android.gm" لتطبيق Gmail وفقًا لرابط Google Play https://play.google.com/store/apps/details?id=com.google.android.gm). يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات تطبيق تابع لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.

appVendor

enum (MobileAppVendor)

غير قابل للتغيير مورّد التطبيق. يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات التطبيقات التابعة لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.

appAnalyticsProviderId

string (int64 format)

غير قابل للتغيير رقم تعريف مقدّم خدمة تحليلات التطبيقات. يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات التطبيقات التابعة لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.

appId

string

غير قابل للتغيير سلسلة تحدِّد بشكل فريد تطبيقًا جوّالاً تم جمع البيانات منه إلى Google Ads API. بالنسبة إلى نظام التشغيل iOS، سلسلة التعريف هي السلسلة المكونة من 9 أرقام التي تظهر في نهاية عنوان URL الخاص بمتجر التطبيقات (على سبيل المثال، "422689480" لتطبيق Gmail الذي يرتبط برابط App Store‏ https://apps.apple.com/us/app/gmail-email-by-google/id422689480). بالنسبة إلى Android، سلسلة المعرّف هي اسم حزمة التطبيق (على سبيل المثال، "com.google.android.gm" لتطبيق Gmail وفقًا لرابط Google Play https://play.google.com/store/apps/details?id=com.google.android.gm). يجب ألا يكون هذا الحقل فارغًا عند إنشاء رابط جديد لإحصاءات تطبيق تابع لجهة خارجية. ولا يمكن تعديله بعد إنشاء الرابط.