Method: customers.uploadUserData

يُحمِّل بيانات المستخدمين المحدَّدة.

قائمة بالأخطاء المعروضة: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز gRPC.

معلمات المسار

المَعلمات
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".

إذا كانت الاستجابة ناجحة، سيحتوي نص الاستجابة على بيانات بالبنية التالية:

تمثيل JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
الحقول
uploadDateTime

string

تاريخ تلقّي الطلب من خلال واجهة برمجة التطبيقات، بالتنسيق التالي: "yyyy-mm-dd hh:mm:ss+|-hh:mm"، على سبيل المثال، "01-01-2019 12:32:45-08:00".
receivedOperationsCount

integer

عدد عمليات بيانات التحميل التي تتلقّاها واجهة برمجة التطبيقات

نطاقات التفويض

يجب توفير نطاق 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)

قائمة بيانات المستخدمين المطلوب إزالتها من قائمة المستخدمين.