Dịch vụ tài nguyên thay đổi
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Cách đơn giản nhất để thay đổi một tài nguyên là sử dụng dịch vụ riêng của tài nguyên đó, nhưng đây cũng là cách kém linh hoạt nhất.
Thay đổi điểm cuối
Sử dụng dịch vụ dành riêng cho tài nguyên là cách đơn giản nhất để biến đổi.
Mỗi tài nguyên có thể thay đổi đều có một dịch vụ tương ứng và một tập hợp các thao tác cho phép bạn tạo, cập nhật hoặc xoá tài nguyên.
Giả sử bạn muốn tạo một Campaign
mới.
Bạn sẽ tạo một đối tượng Campaign
mới, đặt đối tượng đó vào bên trong một CampaignOperation
, rồi gửi đối tượng đó đến điểm cuối CampaignService.MutateCampaigns
.
Bạn có thể thực hiện việc này cho bất kỳ dịch vụ nào của API Google Ads. Ví dụ: nếu muốn thay đổi một AdGroup
, bạn sẽ truyền một AdGroupOperation
chứa AdGroup
đã thay đổi đến điểm cuối AdGroupService.MutateAdGroups
.
Tương tự, nếu muốn sửa đổi một CampaignCriterion
, bạn sẽ sử dụng CampaignCriterionOperation
và gửi đến điểm cuối CampaignCriterionService.MutateCampaignCriteria
.
Vì bạn có thể lặp lại trường operations
của yêu cầu, nên một yêu cầu biến đổi duy nhất có thể chứa nhiều thao tác. Tuy nhiên, mỗi thao tác được xử lý độc lập với tất cả các thao tác khác, vì vậy, bạn không được phép tham chiếu chéo.
Điều này trái ngược với phương thức biến đổi hàng loạt (GoogleAdsService.Mutate
), trong đó các thao tác trong cùng một yêu cầu có thể tham chiếu đến các thực thể từ các thao tác khác.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-08-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-08-27 UTC."],[[["\u003cp\u003eThe most straightforward way to mutate a resource is by using its individual service and corresponding operations (create, update, or remove).\u003c/p\u003e\n"],["\u003cp\u003eEach mutable resource has a dedicated service with specific endpoints for mutation, like \u003ccode\u003eCampaignService.MutateCampaigns\u003c/code\u003e for \u003ccode\u003eCampaign\u003c/code\u003e resources.\u003c/p\u003e\n"],["\u003cp\u003eA single mutate request to a resource-specific service can handle multiple operations, but each operation is treated independently.\u003c/p\u003e\n"],["\u003cp\u003eResource-specific mutation differs from bulk mutation (\u003ccode\u003eGoogleAdsService.Mutate\u003c/code\u003e) where operations can cross-reference each other within the same request.\u003c/p\u003e\n"]]],[],null,["# Resource Service Mutates\n\nUsing a resource's individual service is the most straightforward way to mutate\nit, but also the least flexible.\n\nMutate Endpoints\n----------------\n\nUsing a resource-specific service is the most straightforward way to mutate.\nEach mutable resource has a corresponding service and a set of operations that\nenable you to create, update, or remove the resource.\n\nSuppose you want to create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign).\nYou would create a new [`Campaign`](/google-ads/api/reference/rpc/v21/Campaign)\nobject, put it inside a [`CampaignOperation`](/google-ads/api/reference/rpc/v21/CampaignOperation),\nand then send it to the\n[`CampaignService.MutateCampaigns`](/google-ads/api/reference/rpc/v21/CampaignService/MutateCampaigns)\nendpoint.\n\nYou can do this for any of the Google Ads API services. So for example, if you wanted\nto mutate an [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup), you would pass an\n[`AdGroupOperation`](/google-ads/api/reference/rpc/v21/AdGroupOperation) containing the\nmutated [`AdGroup`](/google-ads/api/reference/rpc/v21/AdGroup) to the\n[`AdGroupService.MutateAdGroups`](/google-ads/api/reference/rpc/v21/AdGroupService/MutateAdGroups) endpoint.\n\nSimilarly, if you want to modify a [`CampaignCriterion`](/google-ads/api/reference/rpc/v21/CampaignCriterion), you would use a\n[`CampaignCriterionOperation`](/google-ads/api/reference/rpc/v21/CampaignCriterionOperation) and send it to the\n[`CampaignCriterionService.MutateCampaignCriteria`](/google-ads/api/reference/rpc/v21/CampaignCriterionService/MutateCampaignCriteria) endpoint.\n\nSince the `operations` field of the request can be repeated, a single mutate\nrequest can contain multiple operations. However, each operation is treated\nindependently from all others, so no cross-referencing is allowed.\n\nThis is in contrast to the bulk mutate method\n([`GoogleAdsService.Mutate`](/google-ads/api/reference/rpc/v21/GoogleAdsService/Mutate)),\nwhere operations within the same request can reference entities from other\noperations."]]