BatchJobService'ın güçlü bir özelliği, geçici kimliklerin kullanımını desteklemesidir.
Bunun için yeni kaynağın resource_name değerini belirterek negatif kimlik kullanabilirsiniz. Örneğin, bir kampanya oluşturur ve kaynak adını customers/<YOUR_CUSTOMER_ID>/campaigns/-1 olarak belirtirseniz daha sonraki bir işlemde reklam grubunu oluştururken reklam grubuna bu kaynak adıyla başvurabilirsiniz. Böylece belirttiğiniz -1, oluşturulan kampanyanın gerçek kimliğiyle otomatik olarak değiştirilir.
Geçici kaynak adlarını kullanırken aklınızda bulundurmanız gereken bazı noktalar şunlardır:
- Geçici kaynak adları 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şlerde veya değişiklik isteklerinde hatırlanmaz. Önceki bir işte oluşturulan bir kaynağa veya değişiklik isteğinde bulunmak için kaynağın gerçek kaynak adını kullanın.
- Tek bir iş veya değişiklik isteği için her geçici kaynak adı, farklı kaynak türlerinden olsalar bile benzersiz bir negatif sayı kullanmalıdır. 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 bir kampanya, reklam grubu ve reklam eklemek istediğinizi varsayalım. İsteğiniz için aşağıdakine benzer bir yapı oluşturabilirsiniz:
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 yeniden kullanılamayacağından, reklam grubu için yeni bir geçici kimlik kullanıldığına dikkat edin. Reklam grubu reklamı oluştururken de bu reklam grubuna başvururuz. Reklam grubunun kendisi, istekte daha önceki bir işlemde kampanya için oluşturduğumuz kaynak adına referans veriyor. Bununla birlikte, ad_group_ad_operation bölgesindeki resource_name başka bir işlem yapmadığından gerekli değildir.