- Yêu cầu HTTP
- Tham số đường dẫn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
- CustomerAssetSetOperation
- MutateCustomerAssetSetResult
- Hãy làm thử!
Tạo hoặc xoá nhóm thành phần của khách hàng. Các trạng thái hoạt động được trả về.
Yêu cầu HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}/customerAssetSets:mutate
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Tham số | |
---|---|
customerId |
Bắt buộc. Mã của khách hàng có nhóm thành phần của khách hàng đang được sửa đổi. |
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 ( |
Trường | |
---|---|
operations[] |
Bắt buộc. Danh sách các thao tác cần thực hiện trên từng nhóm thành phần của khách hàng. |
partialFailure |
Nếu đúng, các thao tác thành công sẽ được thực hiện và các thao tác không hợp lệ sẽ trả về lỗi. Nếu giá trị là false, tất cả các thao tác sẽ được thực hiện trong một giao dịch khi và chỉ khi tất cả các thao tác đó đều hợp lệ. Mặc định là sai. |
validateOnly |
Nếu đúng, yêu cầu sẽ được xác thực nhưng không được thực thi. Chỉ trả về lỗi, không trả về kết quả. |
responseContentType |
Chế độ cài đặt loại nội dung phản hồi. Xác định xem tài nguyên có thể thay đổi hay chỉ tên tài nguyên được trả về sau khi đột biến. |
Nội dung phản hồi
Tin nhắn phản hồi cho một nhóm thành phần của khách hàng có sự thay đổi.
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 |
---|
{ "results": [ { object ( |
Trường | |
---|---|
results[] |
Tất cả kết quả cho trường hợp thay đổi. |
partialFailureError |
Lỗi liên quan đến lỗi thao tác ở chế độ lỗi một phần. Giá trị chỉ được trả về khi internalFailure = true và tất cả lỗi xảy ra trong thao tác. Nếu có bất kỳ lỗi nào xảy ra ngoài thao tác (ví dụ: lỗi xác thực), chúng tôi sẽ trả về lỗi ở cấp RPC. |
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.
CustomerAssetSetOperation
Một thao tác (tạo, xoá) trên một nhóm thành phần của khách hàng.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Trường | |
---|---|
Trường hợp operation . Thao tác biến đổi. operation chỉ có thể là một trong những trạng thái sau: |
|
create |
Tạo thao tác: Không có tên tài nguyên nào được mong đợi cho nhóm thành phần khách hàng mới. |
remove |
Thao tác xoá: Tên tài nguyên cho nhóm thành phần khách hàng đã xoá được mong đợi ở định dạng sau: |
MutateCustomerAssetSetResult
Kết quả cho nhóm thành phần của khách hàng có thay đổi.
Biểu diễn dưới dạng JSON |
---|
{
"resourceName": string,
"customerAssetSet": {
object ( |
Trường | |
---|---|
resourceName |
Được trả về cho các phép toán thành công. |
customerAssetSet |
Nhóm thành phần khách hàng đã thay đổi chỉ có các trường có thể thay đổi sau khi thay đổi. Trường này sẽ chỉ được trả về khi responseContentType được đặt thành "MUTABLE_Resources". |