Menggunakan layanan individual resource adalah cara paling mudah untuk memutasinya, tetapi juga paling tidak fleksibel.
Endpoint Mutasi
Menggunakan layanan khusus resource adalah cara paling mudah untuk melakukan mutasi. Setiap resource yang dapat diubah memiliki layanan yang sesuai dan serangkaian operasi yang memungkinkan Anda membuat, mengupdate, atau menghapus resource.
Misalnya, Anda ingin membuat Campaign
baru.
Anda akan membuat objek Campaign
baru, memasukkannya ke dalam CampaignOperation
,
lalu mengirimkannya ke
endpoint CampaignService.MutateCampaigns
.
Anda dapat melakukannya untuk semua layanan Google Ads API. Jadi, misalnya, jika Anda ingin
memutasi AdGroup
, Anda akan meneruskan
AdGroupOperation
yang berisi
AdGroup
yang dimutasi ke
endpoint AdGroupService.MutateAdGroups
.
Demikian pula, jika Anda ingin mengubah CampaignCriterion
, Anda akan menggunakan
CampaignCriterionOperation
dan mengirimkannya ke
endpoint CampaignCriterionService.MutateCampaignCriteria
.
Karena kolom operations
permintaan dapat diulang, satu permintaan perubahan dapat berisi beberapa operasi. Namun, setiap operasi diperlakukan secara terpisah dari semua operasi lainnya, sehingga tidak ada referensi silang yang diizinkan.
Hal ini berbeda dengan metode mutasi massal
(GoogleAdsService.Mutate
),
tempat operasi dalam permintaan yang sama dapat mereferensikan entitas dari operasi
lain.