Method: customers.uploadUserData

داده های کاربر داده شده را آپلود می کند.

لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError داخلی Error MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

درخواست HTTP

POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای مسیر

مولفه های
customerId

string

ضروری. شناسه مشتری که برای به روز رسانی داده های کاربر.

درخواست بدن

بدنه درخواست حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "operations": [
    {
      object (UserDataOperation)
    }
  ],

  // Union field metadata can be only one of the following:
  "customerMatchUserListMetadata": {
    object (CustomerMatchUserListMetadata)
  }
  // End of list of possible types for union field metadata.
}
زمینه های
operations[]

object ( UserDataOperation )

ضروری. لیست عملیاتی که باید انجام شود.

metadata میدان اتحادیه فراداده درخواست metadata تنها می تواند یکی از موارد زیر باشد:
customerMatchUserListMetadata

object ( CustomerMatchUserListMetadata )

فراداده برای به‌روزرسانی داده‌ها در فهرست کاربران مطابقت مشتری.

بدن پاسخگو

پیام پاسخ برای UserDataService.UploadUserData آپلودهای انجام شده از طریق این سرویس در بخش «اعضای بخش» برای فهرست مطابقت مشتری در رابط کاربری Google Ads قابل مشاهده نخواهد بود.

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:

نمایندگی JSON
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
زمینه های
uploadDateTime

string

زمانی که درخواست توسط API دریافت شد، قالب‌بندی شده به‌عنوان «yyyy-mm-dd hh:mm:ss+|-hh:mm»، برای مثال، «01-01-2019 12:32:45-08:00 ".

receivedOperationsCount

integer

تعداد عملیات داده آپلود دریافت شده توسط API.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/adwords

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

UserDataOperation

عملیاتی که باید برای UploadUserDataRequest انجام شود.

نمایندگی JSON
{

  // Union field operation can be only one of the following:
  "create": {
    object (UserData)
  },
  "remove": {
    object (UserData)
  }
  // End of list of possible types for union field operation.
}
زمینه های
operation میدانی اتحادیه عملیاتی که باید برای UploadUserDataRequest انجام شود. operation می تواند تنها یکی از موارد زیر باشد:
create

object ( UserData )

لیستی از داده های کاربر که باید به لیست کاربر الحاق شود.

remove

object ( UserData )

لیست داده های کاربر که باید از لیست کاربران حذف شوند.