Çoğu kaynak, bir Mutate
yöntemi kullanılarak değiştirilir (oluşturulur, güncellenir veya kaldırılır). Mutate
yöntemi, sondaki kaynak kimliği olmadan kaynak adı kalıbıyla eşleşen kaynağa özel bir URL'ye HTTP POST
olarak çağrılır.
Değiştirilecek kaynakların kimlikleri bunun yerine JSON istek gövdesinde gönderilir. Bu sayede, farklı kaynaklarda birden fazla işlem içeren tek bir API çağrısı gönderebilirsiniz.
Örneğin, bir kampanyanın kaynak adı aşağıdaki biçimi kullanır:
customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID
Değişen kampanyalarda kullanılan URL'yi türetmek için sondaki kaynak kimliğini çıkarıp :mutate
ekleyin:
https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/campaigns:mutate
Mutate
mesajı, birçok operation
nesnesi içerebilen operations
dizisine sahip üst düzey bir JSON nesnesi içerir. Bu durumda her işlem şunlardan biri olabilir: create
, update
veya remove
. Olası tek değişiklik işlemleri bunlardır.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "operations": [ ... ] }
Çoğu hizmet, tek bir API çağrısında binlerce işlemi destekler. Sistem Sınırları rehberinde, istek boyutlarıyla ilgili sınırlamalar belgelenmektedir.
Tek bir API isteği içindeki işlemler, varsayılan olarak bir dizi işlem şeklinde yürütülür. Diğer bir deyişle, hepsi birlikte başarılı olur veya herhangi bir işlem başarısız olursa grubun tamamı başarısız olur. Bazı hizmetler, bu davranışı değiştirmek için partialFailure
özelliğini destekler. Değişim işlemi semantiği hakkında daha ayrıntılı bilgi için Kaynakları Değiştirme bölümüne bakın.
Üret
Oluşturma işlemleri yeni varlıklar üretir ve oluşturmak istediğiniz kaynağın tam JSON temsilini içermelidir.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "operations": [ { "create": { "name": "An example campaign", "status": "PAUSED", "campaignBudget": "customers/CUSTOMER_ID/campaignBudgets/CAMPAIGN_BUDGET_ID", "advertisingChannelType": "SEARCH", "networkSettings": { "targetGoogleSearch": true, "targetSearchNetwork": true, "targetContentNetwork": true, "targetPartnerSearchNetwork": false }, "target_spend": {} } } ] }
Güncelle
Güncelleme işlemleri, mevcut bir kaynakta seyrek güncellemeler gerçekleştirir. Yalnızca değiştirmek istediğiniz alanları belirtmeniz yeterlidir.
Güncellemek istediğiniz alanları belirtmek için updateMask
özelliğini, alan adlarının virgülle ayrılmış bir listesine ayarlayın. Bu, özellikle bir nesnenin tam olarak biçimlendirilmiş bir JSON gösterimine sahipseniz (örneğin, önceki bir API çağrısının döndürdüğü gibi) ancak yalnızca belirli alanları değiştirmek istiyorsanız yararlı olur.
JSON nesnesini budamak yerine, updateMask
içinde değiştirilecek alan adlarını listeleyebilir ve JSON nesnesinin tamamını gönderebilirsiniz.
Aşağıdaki örnekte, belirtilen resourceName
değerine sahip mevcut bir kampanyanın name
ve status
özellikleri değiştirilmiştir.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "operations": [ { "updateMask": "name,status", "update": { "resourceName": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID", "name": "My renamed campaign", "status": "PAUSED", } } ] }
Kaldır
Kaldırma işlemleri, bir nesneyi etkili bir şekilde siler ve Google Ads durumunu REMOVED
olarak ayarlar. Yalnızca kaldırılacak resourceName
gereklidir.
POST /v17/customers/CUSTOMER_ID/campaigns:mutate HTTP/1.1 Host: googleads.googleapis.com Content-Type: application/json Authorization: Bearer ACCESS_TOKEN developer-token: DEVELOPER_TOKEN { "operations": [ { "remove": "customers/CUSTOMER_ID/campaigns/CAMPAIGN_ID" } ] }