Như đã thảo luận trong hướng dẫn về cấu trúc API, mỗi tài nguyên cấp cao nhất trong API Google Ads đều có một dịch vụ tương ứng dành riêng cho loại tài nguyên hỗ trợ:
- Sửa đổi các thực thể của tài nguyên
- Truy xuất một thực thể của tài nguyên để kiểm tra
Hướng dẫn này sẽ sử dụng CampaignService để minh hoạ việc sửa đổi và kiểm tra các đối tượng Campaign, nhưng các khái niệm tương tự cũng áp dụng cho tất cả các dịch vụ khác dành riêng cho loại tài nguyên.
Thay đổi đối tượng
Mỗi dịch vụ dành riêng cho loại tài nguyên sẽ có một phương thức mutate chấp nhận yêu cầu biến đổi. Yêu cầu này bao gồm:
customerId- Tập hợp các phép toán
- Chế độ cài đặt loại nội dung phản hồi xác định liệu tài nguyên có thể thay đổi hay chỉ tên tài nguyên sẽ được trả về sau khi đột biến.
Ví dụ: phương thức MutateCampaigns của CampaignService chấp nhận một MutateCampaignsRequest bao gồm:
customerId- Một tập hợp các đối tượng
CampaignOperation - Trường
response_content_typecho biết loại phản hồi ưu tiên.
Hoạt động tính toán
Đối tượng thao tác như CampaignOperation cho phép bạn chỉ định hành động mà bạn muốn thực hiện trên một tài nguyên bằng cách đặt trường operation của tài nguyên đó. Trường này là một trường oneof bao gồm các thuộc tính sau đây có loại là loại tài nguyên:
create- Tạo một thực thể mới của tài nguyên.
update- Cập nhật tài nguyên để khớp với các thuộc tính của tài nguyên
update. Khi đặt trường này, bạn cũng phải đặtupdate_maskcủa thao tác để cho API Google Ads biết những thuộc tính cần sửa đổi trong thao tác cập nhật. Mỗi thư viện ứng dụng đều có một phương thức tiện ích hoặc trình trợ giúp sẽ tạoupdate_maskcho bạn, như minh hoạ trong thư viện ứng dụng của chúng tôi. remove- Xoá tài nguyên.
Vì trường operation là trường oneof, nên bạn không thể sử dụng một thao tác để sửa đổi nhiều đối tượng. Ví dụ: nếu bạn muốn tạo một chiến dịch và xoá một chiến dịch khác, hãy thêm hai thực thể của CampaignOperation vào yêu cầu: một thực thể có create được đặt và một thực thể khác có remove được đặt.
Thao tác theo lô
Mặc dù một thao tác chỉ có thể tạo, cập nhật hoặc xoá một tài nguyên, nhưng một yêu cầu thay đổi có thể chứa nhiều thao tác. Bạn nên kết hợp các thao tác của mình thành một yêu cầu thay đổi duy nhất thay vì gửi nhiều yêu cầu thay đổi, mỗi yêu cầu chứa một thao tác.
Ví dụ: nếu muốn tạo 10 chiến dịch, bạn nên gửi một MutateCampaignsRequest có 10 đối tượng CampaignOperation.
Thay đổi câu trả lời
Nội dung được trả về trong phản hồi phụ thuộc vào nội dung được gửi trong response_content_type của yêu cầu thay đổi. Ví dụ: nếu bạn chỉ định MUTABLE_RESOURCE, thì phản hồi sẽ chỉ chứa các trường có thể thay đổi trong chiến dịch. Sau đó, bạn có thể thực hiện các thay đổi tiếp theo trên đối tượng tài nguyên đó mà không cần phải tạo lại đối tượng đó.
Lỗi thay đổi
Các thao tác trong một yêu cầu thay đổi nhất định sẽ chỉ được áp dụng cho tài khoản Google Ads của bạn nếu mọi thao tác trong yêu cầu đó đều thành công. Hãy xem hướng dẫn về các lỗi thường gặp để biết danh sách các lỗi thường gặp và cách khắc phục.