يحمّل بيانات المستخدمين المحدّدة.
قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError
طلب HTTP
POST https://googleads.googleapis.com/v14/customers/{customerId}:uploadUserData
يستخدِم عنوان URL بنية تحويل ترميز gRPC.
مَعلمات المسار
المَعلمات | |
---|---|
customerId |
مطلوبة. رقم تعريف العميل المطلوب تعديل بيانات المستخدم له. |
نص الطلب
يحتوي نص الطلب على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "operations": [ { object ( |
الحقول | |
---|---|
operations[] |
مطلوبة. تمثّل هذه السمة قائمة العمليات المطلوب تنفيذها. |
حقل الاتحاد metadata البيانات الوصفية للطلب يمكن أن تكون السمة "metadata " واحدة فقط مما يلي: |
|
customerMatchUserListMetadata |
البيانات الوصفية لتعديل البيانات في قائمة مستخدمي "مطابقة العملاء" |
نص الاستجابة
رسالة الرد لـ UserDataService.UploadUserData
لن تظهر عمليات التحميل التي تم إجراؤها من خلال هذه الخدمة ضمن قسم "أعضاء الشريحة" لقائمة مطابقة العملاء في واجهة مستخدم إعلانات Google.
إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:
تمثيل JSON |
---|
{ "uploadDateTime": string, "receivedOperationsCount": integer } |
الحقول | |
---|---|
uploadDateTime |
التاريخ الذي تم فيه استلام الطلب بواسطة واجهة برمجة التطبيقات، ويكون بالتنسيق "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "2019-01-01 12:32:45-08:00". |
receivedOperationsCount |
عدد عمليات بيانات التحميل التي تلقّتها واجهة برمجة التطبيقات |
نطاقات التفويض
يجب توفير نطاق OAuth التالي:
https://www.googleapis.com/auth/adwords
لمزيد من المعلومات، راجِع نظرة عامة على بروتوكول OAuth 2.0.
UserDataOperation
العملية التي سيتم إجراؤها لـ uploadUserDataRequest.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد operation العملية التي سيتم إجراؤها لـ uploadUserDataRequest. يمكن أن تكون السمة "operation " واحدة فقط مما يلي: |
|
create |
قائمة بيانات المستخدِمين المطلوب إلحاقها بقائمة المستخدِمين |
remove |
قائمة بيانات المستخدمين المراد إزالتها من قائمة المستخدمين |