احتیاط: شما در حال مشاهده اسناد رابط REST API هستید. اکثر کتابخانه های مشتری رسمی ما از gRPC استفاده می کنند. برای جزئیات بیشتر به مقدمه REST مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

AccountLink

نمایندگی JSON
AccountLinkStatus
LinkedAccountType
ThirdPartyAppAnalyticsLinkIdentifier
- نمایندگی JSON

نشان دهنده ارتباط اشتراک گذاری داده بین یک حساب Google Ads و یک حساب دیگر است

نمایندگی 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 Ads. `linked_account` تنها می تواند یکی از موارد زیر باشد:
`thirdPartyAppAnalytics`	`object ( ThirdPartyAppAnalyticsLinkIdentifier )` تغییرناپذیر. پیوند تجزیه و تحلیل برنامه شخص ثالث.

AccountLinkStatus

وضعیت های احتمالی پیوند بین یک مشتری Google Ads و یک حساب دیگر را شرح می دهد.

Enums
`UNSPECIFIED`	مشخص نشده است.
`UNKNOWN`	فقط برای مقدار برگشتی استفاده می شود. نشان دهنده مقدار ناشناخته در این نسخه است.
`ENABLED`	لینک فعال است.
`REMOVED`	پیوند حذف/غیرفعال شد.
`REQUESTED`	پیوند به حساب دیگر درخواست شده است. یک کاربر در حساب دیگر اکنون می‌تواند پیوند را با تنظیم وضعیت روی ENABLED تأیید کند.
`PENDING_APPROVAL`	این پیوند توسط یک کاربر در حساب دیگر درخواست شده است. ممکن است با تنظیم وضعیت بر روی ENABLED توسط کاربر این حساب تایید شود.
`REJECTED`	پیوند توسط تایید کننده رد شده است.
`REVOKED`	لینک توسط کاربری که لینک را درخواست کرده است باطل می شود.

LinkedAccountType

انواع پیوندهای ممکن بین یک مشتری Google Ads و یک حساب دیگر را شرح می دهد.

Enums
`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 فروشگاه App ظاهر می‌شود (به عنوان مثال، "422689480" برای "Gmail" که پیوند فروشگاه App آن 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 فروشگاه App ظاهر می‌شود (به عنوان مثال، "422689480" برای "Gmail" که پیوند فروشگاه App آن 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 ) این فیلد هنگام ایجاد پیوند تجزیه و تحلیل برنامه شخص ثالث جدید نباید خالی باشد. پس از ایجاد پیوند قابل تغییر نیست.