"Nasıl Yapılır?" Kılavuzu

Bu sayfada, sık kullanılan görevlerin API kullanılarak nasıl gerçekleştirileceğiyle ilgili ayrıntılar sunulmaktadır.

Kullanıcı Oluşturma

UserService, Yönetici haklarına sahip bir kullanıcının doğrudan kendi ağında kullanıcı oluşturmasına olanak tanır. Tüm geliştiriciler bunu, yeni kullanıcının kaydolmasını istemeden yapabilir. Örneğin, her API çağrısını Yönetici (e-posta adresinizin varsayılanı) olarak gerçekleştirmek yerine API'yi ilk kez deniyorsanız gerçek dünya iş akışlarını test etmek için Satış Görevlisi, Trafiker veya Reklamveren gibi rollere sahip birkaç kullanıcı oluşturmak isteyebilirsiniz.

1. [e-mail] gibi yeni Gmail adresleri oluşturun. Alternatif olarak, Gmail olmayan mevcut bir adresi yeni bir Google Hesabı olarak kaydedebilirsiniz.
2. createUsers numaralı telefonu bu yeni adres ve seçilen Role ile arayın.
3. Erişim jetonunuzu oluşturmak için OAuth 2.0'ı kullanarak bu yeni kullanıcı olarak kimlik doğrulaması yapabilirsiniz.

Temel Reklam Birimini Öğrenme

Hem alt düğüm ekleyebileceğiniz en üstteki AdUnit öğesi ve hiyerarşinizin izin verilen derinliği hesap türünüze (Küçük İşletme veya Premium) bağlıdır. Alt düğümlerinin değiştirilmesini destekleyen en üstteki AdUnit, etkili kök AdUnit olarak adlandırılır.

Etkili kökü almak için NetworkService.getCurrentNetwork() çağrısı yapın ve döndürülen Network nesnesindeki effectiveRootAdUnitId alanını inceleyin.

Not: Farklı hesap türleri farklı hiyerarşi kalıplarını destekler.

Nesne Sorgulama

Nesneleri, birçok hizmet tarafından sunulan getObjectsByStatement() yöntemini kullanarak arama ölçütlerine göre ararsınız. Nesne belirli bir nesne türüdür. Bu yöntem bir PQL sorgusu alır. Bu sorgu, arama yapılacak alanları (alan adlarının nesnedeki özelliklerle eşlendiği) belirtmenizi, arama sonuçlarınızı sıralamanızı, sınırlamanızı ve dengelemenizi sağlaması açısından SQL sorgusuna benzer. PQL hakkında daha fazla bilgi edinmek ve hangi nesne alanlarına göre filtre yapabileceğinizi öğrenmek için PQL Kılavuzu'na bakın.

Sipariş Oluşturma

Sipariş oluşturmak için bir Order nesnesi oluşturmanız ve reklamveren, satış görevlisi ve trafiker kimliklerini uygun kullanıcılara ayarlamanız, benzersiz bir ad atamanız ve createOrders() yöntemini çağırmanız yeterlidir. Sonuç, yeni oluşturulan Order veya bir hata içerir.

Örnek

Örnek Sipariş oluşturmak için Java kodu bölümüne bakın.

Satır Öğesi Oluşturma

Aşağıda, yeni bir satır öğesi oluşturma adımları verilmiştir:

1. Yeni bir Order nesnesi oluşturun veya mevcut bir nesneyi kullanın.
2. Yeni bir LineItem nesnesi oluşturun ve rotasyon türünü, reklam boyutu dizisini, başlangıç ve bitiş tarihlerini ve diğer özellikleri ayarlayın.
3. Yeni bir InventoryTargeting nesnesi oluşturun ve hangi Placement veya AdUnit nesnelerinin hedefleneceğini ya da hariç tutulacağını belirtin.
4. InventoryTargeting nesnenizi yeni bir Targeting nesnesinin içine sarmalayın ve LineItem hedefleme özelliğine atayın.
5. Yeni nesnenizle createLineItems() satır öğesi hizmet yöntemini çağırın ve nesnenizin oluşturulup oluşturulmadığını görmek için sonucu inceleyin.

Örnek

Örnek Satır öğesi oluşturmak için Java kodu bölümüne bakın.

Reklam Öğesi Oluşturma

Farklı reklam öğesi türleri farklı bileşenleri destekler: Örneğin, bir resim reklam, resim için tek bir kaynak dosyasını destekler; flash reklam öğesi iki temel öğe dosyasını destekler: flash dosyası sunulamamasına karşı bir flash dosyası ve bir yedek resim dosyası. Üçüncü taraf sitelerde barındırılan reklam öğeleri için yalnızca üçüncü taraf sunucudaki dosyaya başvuruda bulunan bir HTML snippet'ini yüklersiniz. Reklam öğenizi oluşturmak üzere yüklemeniz gereken öğeleri öğrenmek için ilgili Creative alt sınıfınıza bakın.

Örnek

Örnek Resim reklam oluşturmak için kullanılan Java kodu bölümüne bakın.

Mevcut Bir Nesneyi Değiştirme

Mevcut bir nesneyi değiştirmek için getObjectsByStatement() yöntemini çağırarak nesnenizi sorgulayın, döndürülen nesnelerdeki değerleri güncelleyin ve ardından updateObjects() çağrısı yapın.

Not: Güncellenen nesneler, mevcut nesnelerin yerini tamamen alır. Bu nedenle, gönderdiğiniz nesnede bir özellik değeri ayarlamayı ihmal ederseniz kaydedilen nesne önceki değeri değil, söz konusu özelliğin varsayılan değerini alır.

Nesne Durumunu Değiştirme

Nesne durumu, hizmetiniz tarafından kullanıma sunulan performObjectAction() yöntemi çağrılarak değiştirilir. Bu yöntem iki parametre alır:

• Yapılmasını istediğiniz işlemi açıklayan işlem nesnesinin örneği. Örneğin, sipariş hizmeti ApproveOrders, PauseOrders ve ArchiveOrders dahil olmak üzere çeşitli işlemleri ortaya çıkarır. İşlem nesnelerinin tümü, hizmetiniz için uygun bir temel işlem sınıfından türetilir.
• Hangi nesnelerin değiştirileceğini açıklayan bir PQL sorgusu. Uygun bir PQL ifadesi belirleyerek tek seferde bir veya daha fazla nesnenin durumunu değiştirebilirsiniz.

Reklam Etiketleri Oluşturma

API'yı kullanarak reklam etiketleri oluşturamazsınız. Bunun yerine Google Ad Manager web sitesini kullanmanız gerekir. Daha fazla bilgi için Etiketleme Yardım Merkezi bölümüne bakın.

Diğer Örnekler

İstemci kitaplığı örnek kodumuzda, birkaç farklı programlama dilinde daha fazla örnek bulabilirsiniz. Programlama dilinizdeki örneklere bağlantı için İstemci Kitaplıkları ve Örnek Kod sayfasına bakın.