- درخواست HTTP
- پارامترهای مسیر
- درخواست بدن
- بدن پاسخگو
- محدوده مجوز
- UserDataOperation
- آن را امتحان کنید!
داده های کاربر داده شده را آپلود می کند.
لیست خطاهای پرتاب شده: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError داخلی Error MutateError OfflineUserDataJobError QuotaError RequestError UserDataError
درخواست HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:uploadUserData
URL از دستور GRPC Transcoding استفاده می کند.
پارامترهای مسیر
مولفه های | |
---|---|
customerId | ضروری. شناسه مشتری که برای به روز رسانی داده های کاربر. |
درخواست بدن
بدنه درخواست حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "operations": [ { object ( |
زمینه های | |
---|---|
operations[] | ضروری. لیست عملیاتی که باید انجام شود. |
metadata میدان اتحادیه فراداده درخواست metadata تنها می تواند یکی از موارد زیر باشد: | |
customerMatchUserListMetadata | فراداده برای بهروزرسانی دادهها در فهرست کاربران مطابقت مشتری. |
بدن پاسخگو
پیام پاسخ برای UserDataService.UploadUserData
آپلودهای انجام شده از طریق این سرویس در بخش «اعضای بخش» برای فهرست مطابقت مشتری در رابط کاربری Google Ads قابل مشاهده نخواهد بود.
در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی داده هایی با ساختار زیر است:
نمایندگی JSON |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
زمینه های | |
---|---|
uploadDateTime | زمانی که درخواست توسط API دریافت شد، قالببندی شده بهعنوان «yyyy-mm-dd hh:mm:ss+|-hh:mm»، برای مثال، «01-01-2019 12:32:45-08:00 ". |
receivedOperationsCount | تعداد عملیات داده آپلود دریافت شده توسط API. |
محدوده مجوز
به محدوده OAuth زیر نیاز دارد:
-
https://www.googleapis.com/auth/adwords
برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.
UserDataOperation
عملیاتی که باید برای UploadUserDataRequest انجام شود.
نمایندگی JSON |
---|
{ // Union field |
زمینه های | |
---|---|
operation میدانی اتحادیه عملیاتی که باید برای UploadUserDataRequest انجام شود. operation می تواند تنها یکی از موارد زیر باشد: | |
create | لیستی از داده های کاربر که باید به لیست کاربر الحاق شود. |
remove | لیست داده های کاربر که باید از لیست کاربران حذف شوند. |