Mart 2022'de Bid Manager API'sinin 2. sürümünü kullanıma sunduk. Raporda yakında 1.1 sürümünün kullanımdan kaldırılacağı tarihi duyurmayı planlıyoruz. Biz 1.1'den v2'ye en kısa sürede taşımanızı öneririz.
Uygulamanızı taşıma
v1.1'den v2'ye geçiş yapmak için uç nokta URL'lerinizin v2'yi çağıracak şekilde güncellenmesi gerekir ve uygulamanızı güncelleyerek zarar veren değişiklikleri hesaba katabilirsiniz.
API çağrılarınızı v1.1'den v2'ye güncelleme
v1.1 yerine v2'yi kullanmak için isteklerinizi yeni v2'yi kullanacak şekilde güncellemeniz gerekir. uç noktalar.
Eşdeğer yöntemleri tanımlama
API çağrılarınızı v1.1'den v2'ye güncellemek için öncelikle 2. sürümdeki eşdeğer v1.1 yöntemleri.
Tüm hizmet ve yöntemlerin aşağıda belirtilen adları sürüm 1.1 ve sürüm 2:
- 1.1 sürümündeki
Queries
veReports
hizmetleri biliniyorqueries
vequeries.reports
olarak kullanılıyor. - Yöntemler v2'de aşağıdaki gibi yeniden adlandırıldı:
Yeni uç noktalarda güncelleme
Eşdeğer yöntemleri belirledikten sonra isteklerinizi güncellemeniz gerekir. Örneğin,
Örneğin, queries.getquery
yöntemini v1.1 ile çağırmak için şunu kullanırsınız:
aşağıdaki URL:
https://www.googleapis.com/doubleclickbidmanager/v1.1/query/queryId
v2'de queries.get
olarak bilinen eşdeğer yöntemi çağırmak için
Bu URL:
GET https://doubleclickbidmanager.googleapis.com/v2/queries/queryId
API'ye istek göndermek için bir istemci kitaplığı kullanıyorsanız son sürümünü edinin ve yapılandırmanızı v2'yi kullanacak şekilde güncelleyin.
Gerekli değişiklikleri yapın
2. sürümde, zarar veren bazı değişiklikler yapıyoruz. Aşağıdakileri inceleyin geçerli talimatları ve mevcut Bid Manager API'si.
queries
hizmetine yapılan aramaları güncelle
Query
kaynağında başlangıçta genel olarak gösterilen aşağıdaki alanlar iç içe yerleştirilmiş nesneler, aşağıdaki nesne türlerini kullanacak şekilde değiştirildi:Query
kaynağında başlangıçta genel olarak gösterilen aşağıdaki alanlar liste nesneleri, aşağıdaki yeni nesne türlerinin listeleri olacak şekilde değiştirildi:Query
kaynağında bulunan ve başlangıçta dizeler, v2'deki enum türleriyle temsil edilir ve aşağıdakileri içerir: değişiklikler:metadata.dataRange
ürününün v2 eşdeğeri artıkRange
kullanıyor enum. Bu sıralamaya dönüştürülürkenPREVIOUS_HALF_MONTH
değeri kaldırıldı veTYPE_NOT_SUPPORTED
değeri şu şekilde değiştirildi:RANGE_UNSPECIFIED
.metadata.format
artıkFormat
sıralaması kullanıyor. Dönüşümde bu sıralamayaEXCEL_CSV
değeri kaldırılmış veFORMAT_UNSPECIFIED
eklendi.params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[].eventFilters[].dimensionFilter.match
. veparams.options.pathQueryOptions.pathFilters[].eventFilters[].dimensionFilter.match
artıkMatch
enum'unu kullanabilirsiniz.params.options.pathQueryOptions.pathFilters[].pathMatchPosition
artık kullanıyorPathMatchPosition
sıralaması. Şuna dönüştürülüyor: bu sıralamadaPATH_MATCH_POSITION_UNSPECIFIED
değeri eklenmiştir.schedule.frequency
artıkFrequency
sıralaması kullanıyor. İçinde bu sıralamaya dönüştürüldüğündeFREQUENCY_UNSPECIFIED
değeri eklenmiştir.params.type
artıkReportType
sıralaması kullanıyor. İçinde bu sıralamaya dönüştürüldüğünde aşağıdaki değişiklikler yapıldı:- Aşağıdaki değerlerin desteği sonlandırıldı:
TYPE_ACTIVE_GRP
TYPE_AUDIENCE_PERFORMANCE
TYPE_CLIENT_SAFE
TYPE_COMSCORE_VCE
TYPE_CROSS_FEE
TYPE_CROSS_PARTNER
TYPE_CROSS_PARTNER_THIRD_PARTY_DATA_PROVIDER
TYPE_ESTIMATED_CONVERSION
TYPE_FEE
TYPE_KEYWORD
TYPE_LINEAR_TV_SEARCH_LIFT
TYPE_NIELSEN_AUDIENCE_PROFILE
TYPE_NIELSEN_DAILY_REACH_BUILD
TYPE_NIELSEN_ONLINE_GLOBAL_MARKET
TYPE_PAGE_CATEGORY
TYPE_PETRA_NIELSEN_DAILY_REACH_BUILD
TYPE_PETRA_NIELSEN_ONLINE_GLOBAL_MARKET
TYPE_PIXEL_LOAD
TYPE_THIRD_PARTY_DATA_PROVIDER
TYPE_TRUEVIEW_IAR
TYPE_VERIFICATION
TYPE_YOUTUBE_VERTICAL
- Kalan değerlerin tümü, sıklık değerlerini daha iyi yansıtacak şekilde güncellenmiştir
eşdeğer değerlere sahip olur:
v1.1 değerleri Eşdeğer ReportType
değeriTYPE_NOT_SUPPORTED
REPORT_TYPE_UNSPECIFIED
TYPE_GENERAL
STANDARD
TYPE_INVENTORY_AVAILABILITY
INVENTORY_AVAILABILITY
TYPE_AUDIENCE_COMPOSITION
AUDIENCE_COMPOSITION
TYPE_ORDER_ID
FLOODLIGHT
TYPE_TRUEVIEW
YOUTUBE
TYPE_NIELSEN_SITE
GRP
TYPE_PETRA_NIELSEN_AUDIENCE_PROFILE
YOUTUBE_PROGRAMMATIC_GUARANTEED
TYPE_REACH_AND_FREQUENCY
REACH
TYPE_REACH_AUDIENCE
UNIQUE_REACH_AUDIENCE
TYPE_PATH
FULL_PATH
TYPE_PATH_ATTRIBUTION
PATH_ATTRIBUTION
metadata.dataRange
alanları,reportDataStartTimeMs
vereportDataEndTimeMs
alanlarla değiştirildirange
,customStartDate
vecustomEndDate
. Yeni tarih alanları,Date
değerini kullanır milisaniye yerine 180.000 civarı gözlemledim. Değiştirilen bu alanlarDataRange
dataRange
alanıQueryMetadata
nesnesini tanımlayın.schedule.startTimeMs
veschedule.endTimeMs
alanlarla değiştirildistartDate
veendDate
QuerySchedule
nesnesini tanımlayın. Yeni tarih alanları,Date
değerini kullanır milisaniye yerine 180.000 civarı gözlemledim.metadata.running
alanları,metadata.reportCount
,metadata.googleCloudStoragePathForLatestReport
,metadata.googleDrivePathForLatestReport
vemetadata.latestReportRunTimeMs
kaldırıldı. Bir sorgunun en son oluşturulan raporlarıyla ilgili bilgiler, bunun yerinequeries.reports.list
"key.reportId desc" değerininorderBy
sorgu parametresini istekte en son raporların ilk sırada listelendiğini garanti edersiniz.- Alanlar
kind
,timezoneCode
,metadata.locale
,params.includeInviteData
veschedule.nextRunMinuteOfDay
kaldırıldı. queries.create
, oluşturulduktan sonra artık sorguları otomatik olarak çalıştırmaz veasynchronous
sorgu parametresi kaldırıldı. Telefonla arama Şu hesapla ilgili raporlar oluşturmak üzerequeries.create
tarihinden sonraqueries.run
: anlamına gelir.queries.run
yöntemi aşağıdaki şekillerde güncellenmiştir:asynchronous
sorgu parametresisynchronous
sorgu parametresi. Yeni sorgu parametresi ters mantıkla çalışır ve belirtilmezse yanlış kabul edilir. Verilenqueries.run
, raporları varsayılan olarak v1.1'de varsayılan ayar olan v2'dir.- İsteğin gövdesi,
timezoneCode
alanına dokunup değiştirin vedataRange
,reportDataStartTimeMs
,reportDataEndTimeMs
alanlarında birDataRange
nesnedataRange
alanına girin. - Yöntem, bir
Report
yerine boş yanıt gövdesi.
queries.list
yanıt gövdesindekikind
alanı kaldırıldı.
reports
hizmetine yapılan aramaları güncelle
Report
kaynağında başlangıçta temsil edilen aşağıdaki alanlar iç içe yerleştirilmiş genel nesneler, aşağıdaki nesne türlerini kullanacak şekilde değiştirildi:Report
kaynağında başlangıçta temsil edilen aşağıdaki alanlar genel liste nesneleri, aşağıdaki yeni nesnenin listeleri olacak şekilde değiştirildi türler:Report
kaynağında başlangıçta temsil edilen aşağıdaki alanlar dizeler değişmiştir ve dolayısıyla v2'deki eşdeğer alanları, yeni ve kabul edilebilir değerlerdeki değişiklikleri dahil edin:metadata.status.format
artıkFormat
sıralaması kullanıyor. İçinde bu sıralamaya dönüştürüldüğündeEXCEL_CSV
değeri kaldırılmış veFORMAT_UNSPECIFIED
eklendi.metadata.status.state
artıkState
sıralaması kullanıyor. İçinde bu sıralamaya dönüştürüldüğünde,QUEUED
veSTATE_UNSPECIFIED
değerleri eklendi.params.options.pathQueryOptions.channelGrouping.rules[].disjunctiveMatchStatements[].eventFilters[].dimensionFilter.match
. veparams.options.pathQueryOptions.pathFilters[].eventFilters[].dimensionFilter.match
artıkMatch
enum'unu kullanabilirsiniz.params.options.pathQueryOptions.pathFilters[].pathMatchPosition
artık kullanıyorPathMatchPosition
sıralaması. Şuna dönüştürülüyor: bu sıralamadaPATH_MATCH_POSITION_UNSPECIFIED
değeri eklenmiştir.params.type
artıkReportType
sıralaması kullanıyor. İçinde bu sıralamaya dönüştürüldüğünde, birçok değişiklik yapılmıştır ve bunlar (sorgular hizmet çağrılarını güncellemeyle ilgili olarak) önceki bölümde yer alan ayrıntılara değineceğiz.
metadata.reportDataStartTimeMs
vemetadata.reportDataEndTimeMs
, şununla değiştirildi: alanlarıreportDataStartDate
vereportDataEndDate
-ReportMetadata
nesnesini ifade eder. Yeni alanlar, Unix Epoch'tan beri milisaniye yerineDate
nesne.metadata.status.finishTimeMs
, şununla değiştirildi:finishTime
alanınıReportStatus
nesnesini tanımlayın. Bu yeni zaman alanı, RFC3339 UTC "Zulu" özelliğinde zaman damgası olarak tarih ve saat biçiminde değil, Unix Epoch'tan beri geçen milisaniye.metadata.status.failure
veparams.includeInviteData
alanları kaldırıldı.reports.list
yanıt gövdesindekikind
alanında kaldırıldı.
Hata işleme mantığını güncelle
API genelindeki hata mesajları v2'de güncellendi. Bu yeni hata mesajları ve bazı durumlarda, buradaki Hatanın döndürülmesine neden olan API istekleri. Mevcut hata belirli bir hata mesajı metnine bağlı olduğundan hatanızı genel hatlarıyla belirtin. ele alacağız.