Geçici kimlikleri kullanma

BatchJobService'in güçlü bir özelliği, geçici kimliklerin kullanımını desteklemesidir.

Negatif bir kimlik kullanmak için yeni kaynağın resource_name değerini belirterek bunu yapabilirsiniz. Örneğin, bir kampanya oluşturur ve kaynak adını customers/<YOUR_CUSTOMER_ID>/campaigns/-1 olarak belirtirseniz sonraki bir işlemde reklam grubunu oluştururken bu kaynak adına başvurabilirsiniz. Böylece belirttiğiniz -1, otomatik olarak oluşturulan kampanyanın gerçek kimliğiyle değiştirilir.

Geçici kaynak adlarını kullanırken aklınızda bulundurmanız gereken bazı noktalar şunlardır:

• Geçici kaynak adı yalnızca bir kaynakta tanımlandıktan sonra kullanılabilir. Aşağıdaki örnekte, reklam grubu işleminin işlemler listesinde kampanya işleminden sonra görünmesi gerekir.
• Geçici kaynak adları, işler veya değişiklik istekleri genelinde hatırlanmaz. Önceki bir işte veya değiştirme isteğinde oluşturulan bir kaynağa referans vermek için gerçek kaynak adını kullanın.
• Tek bir iş veya değiştirme isteği için her geçici kaynak adının farklı kaynak türlerinden olsa bile benzersiz bir negatif sayı kullanması gerekir. Geçici bir kimlik tek bir işte veya değiştirme isteğinde yeniden kullanılırsa bir hata döndürülür.

Örnek

Yukarıda belirtilen duruma daha somut bir örnek vermek için tek bir API isteğine kampanya, reklam grubu ve reklam eklemek istediğinizi varsayalım. İsteğiniz için aşağıdakine benzer bir yapı oluşturmanız gerekir:

mutate_operations: [
  {
    campaign_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1",
        ...
      }
    }
  },
  {
    ad_group_operation: {
      create: {
        resource_name: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2",
        campaign: "customers/<YOUR_CUSTOMER_ID>/campaigns/-1"
        ...
      }
    }
  },
  {
    ad_group_ad_operation: {
      create: {
        ad_group: "customers/<YOUR_CUSTOMER_ID>/adGroups/-2"
        ...
      }
    }
  },
]

Kampanya için kullandığımız -1 tekrar kullanamadığımız ve bir reklam grubu reklamı oluştururken de bu reklam grubuna referans verdiğimizden, reklam grubu için yeni bir geçici kimlik kullanıldığına dikkat edin. Reklam grubunun kendisi, istekteki önceki bir işlemde kampanya için oluşturduğumuz kaynak adına başvuruda bulunur. ad_group_ad_operation öğesinde başka bir işlem söz konusu olmadığından, reklam grubu için resource_name gerekli değildir.