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.
Kiểm tra đối tượng bằng get (Không dùng nữa)
Ngoài việc thay đổi các đối tượng, mỗi dịch vụ dành riêng cho loại tài nguyên cũng có một phương thức get để truy xuất tất cả thuộc tính của một tài nguyên.
Phương thức này chấp nhận một yêu cầu get có thuộc tính duy nhất là resource_name.
Phương thức get là một phương thức tiện lợi do API Google Ads cung cấp để truy xuất tất cả các thuộc tính của một đối tượng. Mặc dù đây là một công cụ tuyệt vời để tìm hiểu API hoặc kiểm tra một đối tượng riêng lẻ cho mục đích gỡ lỗi hoặc giáo dục, nhưng ứng dụng của bạn không nên sử dụng các phương thức get để truy xuất đối tượng nhằm xử lý hoặc báo cáo.
Thay vào đó, hãy sử dụng GoogleAdsService vì lớp này chỉ cho phép bạn truy xuất các thuộc tính cụ thể của đối tượng, hỗ trợ truy xuất các chỉ số hiệu suất và cho phép truyền trực tuyến qua các tập hợp kết quả lớn. Nếu ứng dụng của bạn gửi một lượng lớn yêu cầu lấy, bạn có thể gặp phải giới hạn tốc độ.