Değişim

Çoğu kaynak, bir Mutate kullanılarak değiştirilir (oluşturulur, güncellenir veya kaldırılır). yöntemidir. Mutate yöntemi, kaynağa özel bir HTTP POST olarak çağrılır Sondaki kaynak kimliği olmadan kaynak adı kalıbıyla eşleşen URL. Dönüştürülecek kaynakların kimlikleri bunun yerine JSON isteğinde gönderilir gövde. Bu sayede, aynı sayfada birden fazla işlem içeren tek bir API çağrısı gönderebilirsiniz. farklı kaynaklar.

Ö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ın ve :mutate ekleme:

https://googleads.googleapis.com/v17/customers/CUSTOMER_ID/campaigns:mutate

Mutate mesajı, operations dizisine sahip üst düzey JSON nesnesi içeriyor birçok operation nesne barındırabilir. Buna karşılık her işlem, of: create, update veya remove. Bunlar olası tek mutasyondur anlamına gelir.

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 kılavuzu, ve istek boyutlarına yönelik sınırlamalar vardır.

Tek bir API isteği içindeki işlemler, komut dosyası tarafından Bu durumda hepsi birlikte başarılı olur ya da tüm grup başarısız olursa herhangi bir işlem başarısız olur. Bazı hizmetler bir partialFailure özelliği tıklayın. Kaynakları Değiştirme bölümüne bakın sayfasına göz atın.

Oluştur

Oluşturma işlemleri yeni varlıklar oluşturur ve tam JSON içermelidir ve oluşturmak istediğiniz kaynağın bir temsilidir.

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 ihtiyacınız olanlar tıklayın.

Güncellemek istediğiniz alanları belirtmek için updateMask özelliğini alan adlarının virgülle ayrılmış bir listesi. Bu, özellikle de bir nesnenin tam olarak biçimlendirilmiş bir JSON gösterimine sahip olma (örneğin, bir önceki API çağrısı tarafından döndürüldü) ancak yalnızca belirli alanları değiştirmek istediğinizi varsayalım. JSON nesnesini budamak yerine, nesneye ait alan adlarını doğru bir şekilde updateMask içinde değiştirilir ve JSON nesnesinin tamamını gönderir.

Aşağıdaki örnekte,namestatus resourceName değeri.

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 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"
    }
  ]
}