Google Ads API cung cấp nhiều cách để bạn có thể thay đổi và quản lý tài nguyên theo yêu cầu của mình. Mỗi tài nguyên đều có một dịch vụ tương ứng, giúp bạn thực hiện các hoạt động đột biến một cách linh hoạt. Ví dụ, tài nguyên Campaign có thể được thay đổi qua CampaignService.MutateCampaigns, hoặc bạn có thể sử dụng điểm cuối GoogleAdsService.Mutate để nhóm nhiều thao tác trên các dịch vụ tài nguyên khác nhau, giúp tiết kiệm thời gian và tăng hiệu suất làm việc. Trong bài viết này, chúng tôi sẽ hướng dẫn bạn cách thay đổi tài nguyên một cách hiệu quả và chi tiết nhất.
API Google Ads cung cấp nhiều phương thức để thay đổi tài nguyên, tuỳ thuộc vào từng tình huống cụ thể. Mỗi tài nguyên đều có một dịch vụ tương ứng cho phép thực hiện các hoạt động đột biến (mutate) dành riêng cho loại tài nguyên đó. Ví dụ: đối với tài nguyên Campaign, có thể sử dụng điểm cuối CampaignService.MutateCampaigns để thay đổi các chiến dịch.
Một phương thức khác là sử dụng điểm cuối GoogleAdsService.Mutate, cho phép thực hiện một loạt các lệnh gọi đột biến trên nhiều dịch vụ tài nguyên khác nhau. Cách tiếp cận này mang lại những lợi ích sau:
- Thao tác nhóm trên nhiều dịch vụ tài nguyên: Trong khi các lệnh gọi thông thường chỉ có thể thực thi thao tác trên một dịch vụ tài nguyên duy nhất, GoogleAdsService.Mutate cho phép thao tác đồng thời trên nhiều loại tài nguyên.
- Tên tài nguyên tạm thời: Cho phép kết hợp các thao tác để tạo một thực thể và các thực thể con liên quan chỉ trong một yêu cầu duy nhất. Ví dụ, bạn có thể sử dụng GoogleAdsService.Mutate để tạo toàn bộ cấu trúc của một chiến dịch nếu mỗi bước thực hiện đều thành công.
Lưu ý quan trọng: Nhìn chung, bạn không thể thực hiện thay đổi chéo tài khoản. Một tài khoản chỉ có thể thay đổi các đối tượng do chính tài khoản đó tạo ra, trừ khi đối tượng đã được tạo bởi tài khoản người quản lý khách hàng.
Sử dụng dịch vụ riêng lẻ cho mỗi tài nguyên là cách đơn giản nhất để thực hiện các thay đổi, nhưng đồng thời cũng hạn chế về mặt linh hoạt.
Thay đổi điểm cuối
Khi sử dụng dịch vụ dành riêng cho từng tài nguyên, bạn có thể dễ dàng thay đổi tài nguyên đó. Mỗi tài nguyên đều có dịch vụ tương ứng và cung cấp các thao tác như tạo, cập nhật hoặc xóa tài nguyên.
Ví dụ, nếu bạn muốn tạo mới một Campaign, bạn sẽ tạo một đối tượng Campaign, đặt đối tượng này vào trong CampaignOperation, sau đó gửi đến điểm cuối CampaignService.MutateCampaigns.
Bạn cũng có thể thực hiện thao tác tương tự với bất kỳ dịch vụ API Google Ads nào. Ví dụ, để thay đổi FeedItem, bạn sẽ chuyển đối tượng FeedItemOperation chứa FeedItem đã chỉnh sửa đến điểm cuối FeedItemService.MutateFeedItems.
Vì trường operations trong yêu cầu có thể lặp lại, một yêu cầu thay đổi duy nhất có thể chứa nhiều thao tác. Tuy nhiên, mỗi thao tác sẽ được xử lý riêng lẻ và không có tham chiếu chéo giữa các thao tác.
Điều này khác với phương thức thay đổi hàng loạt (GoogleAdsService.Mutate), nơi các thao tác trong cùng một yêu cầu có thể tham chiếu đến thực thể của các thao tác khác.
Nếu bạn cần thực hiện thao tác trên nhiều loại thực thể cùng lúc hoặc muốn thao tác thông qua một điểm cuối duy nhất thay vì sử dụng các điểm cuối riêng biệt cho từng tài nguyên, GoogleAdsService.Mutate là lựa chọn tối ưu cho tất cả các thao tác thay đổi được hỗ trợ.
Lưu ý: Bạn có thể tham khảo danh sách đầy đủ các thao tác được hỗ trợ trên trang tài liệu tham khảo dành cho MutateOperation.
Thay đổi hoạt động
Mỗi MutateGoogleAdsRequest chấp nhận một danh sách lặp lại của MutateOperation, trong đó mỗi thao tác có thể bao gồm một hành động cho một loại tài nguyên. Ví dụ, nếu bạn muốn tạo một tài khoản và một nhóm quảng cáo trong cùng một yêu cầu tới GoogleAdsService.Mutate, bạn cần tạo hai MutateOperation riêng biệt (một cho CampaignOperation và một cho AdGroupOperation), sau đó truyền cả hai vào GoogleAdsService.
Ví dụ bằng Ruby:
mutate_operation1 = client.operation(:Mutate)
mutate_operation2 = client.operation(:Mutate)ad_group_operation = client.operation(:AdGroup)
mutate_operation1.campaign_operation = campaign_operation
mutate_operation2.ad_group_operation = ad_group_operation
Giống như các dịch vụ khác, điểm cuối này cũng hỗ trợ lỗi một phần và chỉ xác thực.
Việc thay đổi tài nguyên trong Google Ads API đòi hỏi sự linh hoạt và tối ưu hoá các thao tác để đảm bảo hiệu quả hoạt động. Sử dụng đúng các điểm cuối như CampaignService.MutateCampaigns hoặc GoogleAdsService.Mutate sẽ giúp bạn quản lý và cập nhật tài nguyên một cách dễ dàng, ngay cả khi làm việc với nhiều loại thực thể khác nhau. Nắm vững các thao tác này sẽ giúp bạn tối ưu hóa quy trình làm việc và khai thác tối đa tiềm năng của Google Ads API.
