- 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
- AdGroupAssetSetOperation
- MutateAdGroupAssetSetResult
- Hãy làm thử!
Tạo hoặc xoá nhóm thành phần của nhóm quảng cáo. 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}/adGroupAssetSets: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 nhóm quảng cáo đ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 nhóm quảng cáo. |
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 nhóm quảng cáo 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.
AdGroupAssetSetOperation
Một thao tác (tạo, xoá) trên nhóm thành phần của nhóm quảng cáo.
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 nhóm quảng cáo mới. |
remove |
Thao tác xoá: Tên tài nguyên cho nhóm thành phần đã xoá của nhóm quảng cáo cần được xoá ở định dạng sau: |
MutateAdGroupAssetSetResult
Kết quả cho nhóm thành phần của nhóm quảng cáo sẽ thay đổi.
Biểu diễn dưới dạng JSON |
---|
{
"resourceName": string,
"adGroupAssetSet": {
object ( |
Trường | |
---|---|
resourceName |
Được trả về cho các phép toán thành công. |
adGroupAssetSet |
Nhóm thành phần nhóm quảng cáo đã 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". |