Ads Data Hub API

Ads Data Hub sorgularını yürütmeyi sağlayan API.

Hizmet: adsdatahub.googleapis.com

Bu hizmeti çağırmak için Google tarafından sağlanan istemci kitaplıklarını kullanmanızı öneririz. Uygulamanızın bu hizmeti çağırmak için kendi kitaplıklarınızı kullanması gerekiyorsa API isteklerinde bulunurken aşağıdaki bilgileri kullanın.

Keşif dokümanı

Discovery Dokümanı, REST API'lerini açıklamak ve kullanmak için makine tarafından okunabilir bir spesifikasyondur. İstemci kitaplıkları, IDE eklentileri ve Google API'ları ile etkileşimde bulunan diğer araçları oluşturmak için kullanılır. Bir hizmet, birden fazla keşif dokümanı sağlayabilir. Bu hizmet, aşağıdaki keşif dokümanını sağlar:

Hizmet uç noktası

Hizmet uç noktası, bir API hizmetinin ağ adresini belirten temel URL'dir. Bir hizmette birden fazla hizmet uç noktası olabilir. Bu hizmet, aşağıdaki hizmet uç noktasına sahiptir ve aşağıdaki tüm URI'ler bu hizmet uç noktasına göre çalışır:

  • https://adsdatahub.googleapis.com

REST Kaynağı: v1.customers

Yöntemler
describeValidDv360AdvertiserIds POST /v1/{customer=customers/*}:describeValidDv360AdvertiserIds
Geçerli DV360 Reklamveren Kimliklerini açıklar
describeValidFrequencyLimitingEventMatchers GET /v1/{customer=customers/*}:describeValidFrequencyLimitingEventMatchers
Geçerli etkinlik eşleştiricileri, sıklık sınırı kitle listeleri için meta verileriyle birlikte listeler.
exportJobHistory POST /v1/{customer=customers/*}:exportJobHistory
Bir müşteri hesabının iş geçmişini müşteri tarafından seçilen BigQuery veri kümesine aktarır.
generateDv360IvtVideoViewabilityReport POST /v1/{customer=customers/*}:generateDv360IvtVideoViewabilityReport
DV360 platformu için geçersiz trafik görüntülenebilirliği metriklerini almak üzere bir sorgunun yürütülmesini başlatır.
generateIvtReport POST /v1/{name=customers/*}:generateIvtReport
Belirli bir platformdaki geçersiz trafik sayılarının günlük özetini almak için bir sorgunun yürütülmesini başlatır.
get GET /v1/{name=customers/*}
İstenen Ads Data Hub müşterisini alır.
getImportCompletionStatus GET /v1/{customer=customers/*}/importCompletionStatus
Belirli bir tarihte ADH'ye başarılı bir şekilde beslenen tüm müşteriler içindeki Google verilerinin yüzdesini döndürür.
list GET /v1/customers
Mevcut kullanıcının erişebildiği Ads Data Hub müşterilerini listeler.

REST Kaynağı: v1.customers.adsDataCustomers

Yöntemler
get GET /v1/{name=customers/*/adsDataCustomers/*}
İstenen Ads Data Hub müşterisini alır.
getDataAccessBudget GET /v1/{name=customers/*/adsDataCustomers/*/dataAccessBudget}
Son 366 gün için istenen reklam veri kaynağına ait veri erişim bütçesini alır.
list GET /v1/{parent=customers/*}/adsDataCustomers
Müşteri tarafından erişilebilen reklam verilerini listeler.

REST Kaynağı: v1.customers.analysisSorgular

Yöntemler
create POST /v1/{parent=customers/*}/analysisQueries
Daha sonra yürütmek için bir analiz sorgusu oluşturur.
delete DELETE /v1/{name=customers/*/analysisQueries/*}
Analiz sorgusunu siler.
get GET /v1/{name=customers/*/analysisQueries/*}
İstenen analiz sorgusunu alır.
list GET /v1/{parent=customers/*}/analysisQueries
Belirtilen müşterinin sahip olduğu analiz sorgularını listeler.
patch PATCH /v1/{query.name=customers/*/analysisQueries/*}
Mevcut bir analiz sorgusunu günceller.
start POST /v1/{name=customers/*/analysisQueries/*}:start
Depolanan analiz sorgusunda yürütme işlemini başlatır.
startTransient POST /v1/{parent=customers/*}/analysisQueries:startTransient
Geçici bir analiz sorgusunda yürütmeyi başlatır.
validate POST /v1/{parent=customers/*}/analysisQueries:validate
Sağlanan analiz sorgusunda statik doğrulama kontrolleri gerçekleştirir.

REST Kaynağı: v1.customers.customBiddingAlgorithms

Yöntemler
addAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:addAdvertiser
Özel teklif verme algoritmasının reklamverenlerine bir DV360 reklamvereni ekleyin.
create POST /v1/{parent=customers/*}/customBiddingAlgorithms
Ads Data Hub tarafından yönetilen özel bir teklif verme algoritması oluşturur.
delete DELETE /v1/{name=customers/*/customBiddingAlgorithms/*}
Bu özel teklif verme algoritmasını silin.
execute POST /v1/{name=customers/*/customBiddingAlgorithms/*}:execute
Özel teklif verme modellerinin son 30 gün içindeki gösterimlerini puanlar.
get GET /v1/{name=customers/*/customBiddingAlgorithms/*}
Ads Data Hub tarafından yönetilen özel teklif verme algoritmasını alır.
list GET /v1/{parent=customers/*}/customBiddingAlgorithms
Belirtilen Ads Data Hub müşterisi tarafından yönetilen özel teklif verme algoritmalarını listeler.
patch PATCH /v1/{customBiddingAlgorithm.name=customers/*/customBiddingAlgorithms/*}
İstenen Ads Data Hub tarafından yönetilen özel teklif verme algoritmasını günceller.
removeAdvertiser POST /v1/{customBiddingAlgorithm=customers/*/customBiddingAlgorithms/*}:removeAdvertiser
Bir DV360 reklamverenini özel teklif verme algoritmasının reklamverenlerinden kaldırın.

REST Kaynağı: v1.customers.tables

Yöntemler
get GET /v1/{name=customers/*/tables/*}
İstenen Ads Data Hub tablosunu alır.
list GET /v1/{parent=customers/*}/tables
Belirtilen müşterinin erişebildiği Ads Data Hub tablolarını listeler.

REST Kaynağı: v1.customers.tempTables

Yöntemler
get GET /v1/{name=customers/*/tempTables/*}
İstenen Ads Data Hub geçici tablosunu alır.
list GET /v1/{parent=customers/*}/tempTables
Müşterinin oluşturduğu Ads Data Hub geçici tablolarını listeler.

REST Kaynağı: v1.customers.userListSorgular

Yöntemler
create POST /v1/{parent=customers/*}/userListQueries
Daha sonra gerçekleştirilecek bir kullanıcı listesi sorgusu oluşturur.
delete DELETE /v1/{name=customers/*/userListQueries/*}
Kullanıcı listesi sorgusunu siler.
get GET /v1/{name=customers/*/userListQueries/*}
İstenen kullanıcı listesi sorgusunu getirir.
list GET /v1/{parent=customers/*}/userListQueries
Belirtilen müşteriye ait kullanıcı listesi sorgularını listeler.
patch PATCH /v1/{query.name=customers/*/userListQueries/*}
Mevcut bir kullanıcı listesi sorgusunu günceller.
start POST /v1/{name=customers/*/userListQueries/*}:start
Saklanan bir kullanıcı listesi sorgusunda yürütmeyi başlatır.
startTransient
(deprecated)		 POST /v1/{parent=customers/*}/userListQueries:startTransient
Geçici kullanıcı listesi sorgusunda yürütmeyi başlatır.
validate POST /v1/{parent=customers/*}/userListQueries:validate
Sağlanan kullanıcı listesi sorgusunda statik doğrulama kontrolleri gerçekleştirir.

REST Kaynağı: v1.customers.userLists

Yöntemler
addEventMatchers POST /v1/{userList=customers/*/userLists/*}:addEventMatchers
Sıklık tabanlı bir kullanıcı listesine etkinlik eşleştiriciler ekler.
addRecipients POST /v1/{userList=customers/*/userLists/*}:addRecipients
Ads Data Hub tarafından yönetilen kullanıcı listesinin alıcılarına varlık ekleyin.
create POST /v1/{parent=customers/*}/userLists
Ads Data Hub tarafından yönetilen bir kullanıcı listesi oluşturur.
delete DELETE /v1/{name=customers/*/userLists/*}
İstenen Ads Data Hub tarafından yönetilen kullanıcı listesini silin.
generateFrequencyListMemberships POST /v1/{name=customers/*/userLists/*}:generateFrequencyListMemberships
UserList için üyelikler oluşturun.
get GET /v1/{name=customers/*/userLists/*}
İstenen Ads Data Hub tarafından yönetilen kullanıcı listesini alır.
list GET /v1/{parent=customers/*}/userLists
Belirtilen Ads Data Hub müşterisi tarafından yönetilen kullanıcı listelerini listeler.
patch PATCH /v1/{userList.name=customers/*/userLists/*}
Ads Data Hub tarafından yönetilen istenen kullanıcı listesini günceller.
removeRecipients POST /v1/{userList=customers/*/userLists/*}:removeRecipients
Ads Data Hub tarafından yönetilen kullanıcı listesinin alıcılarından varlıkları kaldırır.

REST Kaynağı: v1.operations

Yöntemler
cancel POST /v1/{name=operations/**}:cancel
Uzun süreli işlemlerde eşzamansız iptal işlemini başlatır.
delete DELETE /v1/{name=operations/**}
Uzun süreli işlemleri siler.
get GET /v1/{name=operations/**}
Uzun süreli bir işlemin en son durumunu alır.
list GET /v1/{name}
İstekte belirtilen filtreyle eşleşen işlemleri listeler.
wait POST /v1/{name=operations/**}:wait
Belirtilen uzun süreli işlemin tamamlanmasını bekler veya en son belirtilen durumu döndürerek belirtilen bir zaman aşımının aşılmasını bekler.

REST Kaynağı: v1.outages

Yöntemler
list GET /v1/outages
Kesintileri azalan düzende kesinti başlangıç zaman damgasına göre listeleyin ve yeniden inceleme aralığı 130 gündür.