Method: customers.uploadUserData

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

قائمة الأخطاء التي تظهر: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

طلب HTTP

POST https://googleads.googleapis.com/v15/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"، على سبيل المثال، "2019-01-01 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)

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