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

Bu sayfada, sık gerçekleştirilen görevlerin API kullanılarak nasıl gerçekleştirileceği hakkında ayrıntılı bilgi verilmektedir.

Kullanıcı Oluşturma

UserService, oluşturmak için Yönetici haklarına sahip bir kullanıcı kullanıcının doğrudan ağında. Herhangi bir geliştirici bunu yeni kullanıcının kaydolmasını sağlamak. Örneğin, her API çağrısını Yönetici olarak gerçekleştirmek yerine (varsayılan) e-posta adresiniz yoksa) gibi rollere sahip birkaç kullanıcı oluşturabilirsiniz. Gerçek dünyadaki iş akışlarını test etmek için Satış Görevlisi, Trafiker veya Reklamveren.

  1. my.name.salesperson@gmail.com gibi yeni Gmail adresleri oluşturun. Alternatif olarak: gmail dışı mevcut bir adresi yeni e-posta adresi olarak Google Hesabı.
  2. createUsers numaralı telefonu, yeni adresi ve seçtiğiniz Role bilgisini kullanarak arayın.
  3. Erişim jetonunuzu oluşturmak için OAuth 2.0 kullanarak bu yeni kullanıcı olarak kimlik doğrulaması yapabilirsiniz.

Kök Reklam Birimini Alma

Hem alt düğüm ekleyebileceğiniz en üstteki AdUnit hem de 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() yöntemini çağırı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 İçin Sorgulama

getObjectsByStatement() yöntemini kullanarak arama ölçütlerine göre nesne arıyorsunuz birçok hizmet tarafından maruz kalır. Burada Object belirli bir nesne türüdür. Bu yöntemi bir SQL sorgusuna benzer; bir PQL sorgusu alır. Bu yöntem, alan adları (alan adlarının nesnedeki özelliklerle eşlendiği yer), sıralayın, ayarlayabilirsiniz. Bkz. PQL PQL hakkında daha fazla bilgi edinme ve hangi nesne alanlarını yapabileceğinizi öğrenmeniz için filtreleme ölçütü.

Sipariş Oluşturma

Sipariş oluşturmak için bir Order nesnesi oluşturmanız ve reklamvereni, trafiker kimliklerinin ve satış görevlilerinin, uygun kullanıcılara, benzersiz bir ad ve createOrders() numaralı telefonu arayın. Sonuç, yeni oluşturulan Order öğesini içerir, veya bir hata olabilir.

Örnek

Sipariş oluşturmak için Java kodu örneğini inceleyin.

Satır Öğesi Oluşturma

Yeni bir satır öğesi oluşturmak için şu adımları uygulayın:

  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 görürsünüz.
  3. Yeni bir InventoryTargeting nesnesi oluşturun ve hedeflenecek veya hariç tutulacak Placement ya da AdUnit nesnelerini belirtin.
  4. InventoryTargeting nesnenizi yeni bir Targeting nesnesinin içine sarmalayın ve LineItem cihazınızın hedefleme mülküne ekleyin.
  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

Satır öğesi oluşturmak için Java kodu örneğini inceleyin.

Reklam Öğesi Oluşturma

Farklı reklam öğesi türleri, farklı bileşenleri destekler: Örneğin, bir resim reklam öğesi, resim için tek bir kaynak dosyayı destekler; Flash reklam öğesi, iki temel öğe dosyası vardır: bir flash dosyası ve bir yedek resim dosyası (Flash dosyası sunulamıyor. Üçüncü taraf sitelerinde barındırılan reklam öğeleri için yalnızca üçüncü taraf sunucudaki dosyaya başvuruda bulunan bir HTML snippet'i. Bkz. sırayla yüklemek istediğiniz öğeleri öğrenmek için belirli bir Creative alt sınıfı tıklayın.

Örnek

Resim reklam oluşturmaya ilişkin Java kodu örneğini inceleyin.

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 updateObjects() işlevini çağırın.

Not: Güncellenen nesneler, mevcut nesnelerin tamamen yerini alacağından gönderdiğiniz nesnede bir özellik değeri ayarlamayı ihmal ederseniz, kaydedilen nesne o mülk için önceki değeri değil, varsayılan değeri al.

Nesne Durumunu Değiştirme

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

  • Yapmak istediğiniz işlemi açıklayan işlem nesnesinin örneği. Örneğin, sipariş hizmeti; ApproveOrders, PauseOrders, ve ArchiveOrders. İşlem nesnelerinin tümü temel işlemden türetilir bir sınıfa sahip olmanız gerekir.
  • Hangi nesnelerin değiştirileceğini açıklayan bir PQL sorgusu. Şunları değiştirebilirsiniz: uygun bir PQL belirterek bir kerede bir veya daha fazla nesnenin durumu ifade eder.

Reklam Etiketleri Oluşturma

API'yi kullanarak reklam etiketleri oluşturamazsınız; Google Ad Manager web sitesini kullanmanız gerekir. Etiketleme Yardım Merkezi'ndeki daha fazla bilgi edinin.

Diğer Örnekler

İstemci kitaplığı örnek kodumuzda daha birçok örnek bulabilirsiniz. farklı programlama dillerine çevirmesini sağlar. İstemci Kitaplıkları Örnek Kod sayfasını ziyaret edin.