Method: customers.uploadUserData

Tải dữ liệu người dùng cụ thể lên.

Danh sách lỗi đã gửi: AuthenticationError AuthorizationError CollectionSizeError FieldError HeaderError InternalError MutateError OfflineUserDataJobError QuotaError RequestError UserDataError

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Các tham số
customerId

string

Bắt buộc. Mã của khách hàng cần cập nhật dữ liệu người dùng.

Nội dung yêu cầu

Nội dung yêu cầu chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng 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.
}
Các trường
operations[]

object (UserDataOperation)

Bắt buộc. Danh sách thao tác cần thực hiện.
Trường nhóm metadata. Siêu dữ liệu của yêu cầu. metadata chỉ có thể là một trong những trạng thái sau đây:
customerMatchUserListMetadata

object (CustomerMatchUserListMetadata)

Siêu dữ liệu về nội dung cập nhật dữ liệu cho danh sách người dùng So khớp khách hàng.

Nội dung phản hồi

Thông báo phản hồi cho UserDataService.UploadUserData Những tệp tải lên được thực hiện qua dịch vụ này sẽ không xuất hiện trong mục "Thành viên trong phân khúc" trên Danh sách So khớp khách hàng trên giao diện người dùng Google Ads.

Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:

Biểu diễn dưới dạng JSON 
{
  "uploadDateTime": string,
  "receivedOperationsCount": integer
}
Các trường
uploadDateTime

string

Ngày giờ mà API nhận được yêu cầu, có định dạng là "yyyy-mm-dd hh:mm:ss+|-hh:mm", ví dụ: "2019-01-01 12:32:45-08:00".
receivedOperationsCount

integer

Số hoạt động tải lên dữ liệu mà API nhận được.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

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

Để biết thêm thông tin, hãy xem Tổng quan về OAuth 2.0.

UserDataOperation

Thao tác cần thực hiện cho UploadUserDataRequest.

Biểu diễn dưới dạng 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.
}
Các trường
Trường nhóm operation. Thao tác cần thực hiện cho UploadUserDataRequest. operation chỉ có thể là một trong những trạng thái sau đây:
create

object (UserData)

Danh sách dữ liệu người dùng cần được thêm vào danh sách người dùng.
remove

object (UserData)

Danh sách dữ liệu người dùng cần xoá khỏi danh sách người dùng.