API Google Ads là công cụ mạnh mẽ cho phép bạn quản lý và tối ưu hóa chiến dịch quảng cáo một cách tự động và hiệu quả. Để đảm bảo các chiến dịch hoạt động đúng cách, việc hiểu cách sửa đổi và kiểm tra đối tượng thông qua API là rất quan trọng. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách sử dụng CampaignService để thực hiện các thao tác như tạo mới, cập nhật hoặc xóa chiến dịch. Đồng thời, bạn sẽ học cách kiểm tra đối tượng, quản lý phản hồi sau khi thay đổi, và cách xử lý các lỗi phổ biến khi làm việc với Google Ads API.
Mục tiêu: Hiểu cách sửa đổi và kiểm tra đối tượng trong API Google Ads.
Như đã được đề cập 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, được thiết kế để hỗ trợ:
- Sửa đổi các bản sao của tài nguyên.
- Truy xuất một thực thể duy nhất của tài nguyên để kiểm tra.
Trong hướng dẫn này, chúng tôi sẽ sử dụng CampaignService để minh họa quy trình sửa đổi và kiểm tra các đối tượng Campaign. Tuy nhiên, các nguyên tắc này cũng áp dụng tương tự cho tất cả các dịch vụ khác trong API Google Ads, tùy thuộc vào loại tài nguyên mà bạn làm việc.
Từ khoá chính: Tài nguyên cấp cao nhất là những tài nguyên có tên không chứa dấu chấm (“.”). Ví dụ, Campaign là tài nguyên cấp cao nhất, nhưng Campaign.NetworkSettings thì không.
Thay đổi đối tượng
Mỗi dịch vụ trong API Google Ads, tương ứng với từng loại tài nguyên, đều có phương thức mutate để chấp nhận các yêu cầu thay đổi. Yêu cầu này bao gồm các thành phần:
- customerId: Mã nhận dạng khách hàng.
- Tập hợp các phép toán: Các hoạt động muốn thực hiện trên tài nguyên.
- response_content_type: Chế độ cài đặt loại nội dung phản hồi, cho biết liệu tài nguyên có thể thay đổi hay chỉ trả về tên tài nguyên sau khi thay đổi.
Ví dụ, phương thức MutateCampaigns của CampaignService chấp nhận một MutateCampaignsRequest, bao gồm:
- customerId: Mã nhận dạng khách hàng.
- CampaignOperation: Tập hợp các đối tượng hoạt động trên chiến dịch.
- response_content_type: Trường chỉ định loại phản hồi mong muốn.
Hoạt động tính toán
Đối tượng CampaignOperation cho phép bạn chỉ định hành động cần thực hiện trên một tài nguyên đơn lẻ bằng cách sử dụng trường operation. Trường này thuộc loại oneof, nghĩa là chỉ có một trong các hành động sau được thực hiện:
- create: Tạo mới một tài nguyên.
- update: Cập nhật một tài nguyên hiện tại để khớp với các thuộc tính được chỉ định. Khi sử dụng hành động này, bạn cần xác định update_mask, giúp API Google Ads biết rõ các thuộc tính nào cần sửa đổi. Mỗi thư viện ứng dụng có một tiện ích hoặc phương thức hỗ trợ để tạo update_mask.
- remove: Xóa tài nguyên khỏi hệ thống.
Do operation là trường oneof, bạn không thể sử dụng một thao tác để thực hiện nhiều hành động. Ví dụ, nếu bạn muốn tạo mới một chiến dịch và đồng thời xóa một chiến dịch khác, bạn cần gửi hai đối tượng CampaignOperation: một đối tượng sử dụng create và đối tượng còn lại sử dụng remove.
Thao tác theo lô
Mặc dù một thao tác đơn lẻ chỉ có thể tạo, cập nhật hoặc xóa một tài nguyên, bạn có thể gửi nhiều thao tác trong một yêu cầu thay đổi duy nhất. Việc kết hợp nhiều thao tác vào cùng một yêu cầu thay đổi không chỉ tăng hiệu suất mà còn giúp giảm số lượng yêu cầu cần gửi đi. Thay vì gửi nhiều yêu cầu thay đổi riêng lẻ cho từng thao tác, hãy tối ưu hóa bằng cách nhóm các thao tác lại trong một yêu cầu duy nhất.
Ví dụ: nếu bạn cần tạo 10 chiến dịch, thay vì gửi 10 yêu cầu riêng lẻ, bạn nên gửi một MutateCampaignsRequest duy nhất chứa 10 đối tượng CampaignOperation.
Thay đổi phản hồi
Nội dung phản hồi sẽ phụ thuộc vào thiết lập trong trường response_content_type của yêu cầu thay đổi. Ví dụ, nếu bạn chỉ định MUTABLE_RESOURCE, phản hồi sẽ chỉ bao gồm các trường có thể thay đổi trong chiến dịch. Điều này cho phép bạn thực hiện các thay đổi bổ sung trên đối tượng tài nguyên mà không cần phải tạo mới hoàn toàn.
Lỗi thay đổi
Mọi thao tác trong một yêu cầu thay đổi chỉ được áp dụng nếu tất cả các thao tác trong yêu cầu đó thành công. Nếu có bất kỳ thao tác nào thất bại, không có thay đổi nào được thực hiện. Bạn có thể tham khảo hướng dẫn về các lỗi thường gặp để biết danh sách các lỗi phổ biến và cách khắc phục.
Cảnh báo: Phương thức get không còn được hỗ trợ. Thay vào đó, hãy sử dụng search hoặc searchStream để truy xuất các đối tượng.
Kiểm tra đối tượng bằng phương thức get (đã ngừng hỗ trợ)
Trước đây, ngoài việc thay đổi đối tượng, mỗi dịch vụ dành riêng cho từng loại tài nguyên trong Google Ads API có phương thức get để truy xuất tất cả thuộc tính của một tài nguyên duy nhất. Phương thức này chấp nhận yêu cầu get với tham số duy nhất là resource_name.
Lưu ý quan trọng: Hãy thận trọng khi sử dụng phương thức get.
Mặc dù get là một công cụ hữu ích để dễ dàng truy xuất tất cả các thuộc tính của một đối tượng duy nhất, đặc biệt khi bạn muốn tìm hiểu cấu trúc API hoặc kiểm tra đối tượng cho mục đích gỡ lỗi hoặc giáo dục, nhưng phương thức này không được khuyến khích sử dụng để xử lý hàng loạt dữ liệu hoặc báo cáo. Thay vào đó, bạn nên sử dụng GoogleAdsService. Phương thức này cho phép bạn chỉ 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à cung cấp khả năng truyền trực tuyến qua các tập hợp kết quả lớn.
Việc gửi quá nhiều yêu cầu get có thể dẫn đến tình trạng vượt quá giới hạn số lượng yêu cầu của API, vì vậy bạn cần chuyển sang sử dụng search hoặc searchStream để tối ưu hóa việc truy xuất dữ liệu.
Việc nắm vững cách sửa đổi và kiểm tra đối tượng trong API Google Ads là kỹ năng quan trọng giúp bạn quản lý chiến dịch một cách hiệu quả và tiết kiệm thời gian. Từ việc tạo chiến dịch mới đến cập nhật và xóa các đối tượng, các phương pháp và thao tác này giúp tối ưu hóa quá trình quản lý tài khoản quảng cáo. Bằng cách sử dụng các phương thức như MutateCampaigns và GoogleAdsService, bạn sẽ giảm thiểu rủi ro lỗi và cải thiện hiệu suất chiến dịch. Hãy đảm bảo rằng bạn luôn cập nhật và theo dõi các thay đổi mới nhất trong API để chiến dịch của mình hoạt động hiệu quả nhất.
