Giriş
Linking API, kullanıcıları yapılandırmak ve URL üzerinden doğrudan Looker Studio raporuna yönlendirmek için güvenilir bir arayüz sağlar. Kullanıcılar bir Bağlantı API'si URL'sini takip ettiklerinde, verilerini hızlı bir şekilde görüntülemek ve bunlarla etkileşime geçmek için kolay bir deneyime sahip olurlar.
Bu dokümanda, API URL'lerini bağlamanın gerekli biçimi ve mevcut parametreler açıklanmaktadır.
Kullanım alanı ve avantajları
Bağlantı API'si, müşterilerinizin verilerini görüntülemesi ve bunlarla etkileşim kurması için önceden yapılandırılmış raporlar sunmak için kullanılabilir. Linking API'nin temel avantajları şunlardır:
- Müşterileriniz için tek tıklamayla rapor oluşturma deneyimi.
- Veri yapılandırması URL'de sağlanır. Böylece kullanıcıların, raporu verileri için yapılandırması gerekmez.
- Kullanıcılar tek bir tıklamayla raporu kaydedip diledikleri zaman tekrar ziyaret edebilirler.
- Geniş ölçekte raporlar oluşturun. Linking API, yeni raporları kopyalamak veya oluşturmak için gereken süreyi kısaltır.
- Ürün entegrasyonlarını etkinleştirin. Kararlı arayüz, Looker Studio'yu ürün iş akışına entegre etmenize olanak tanır.
İşleyiş şekli
Aşağıda, geliştiricilerin ve kullanıcıların Linking API ile nasıl etkileşimde bulundukları açıklanmaktadır.
API geliştiricisi iş akışını bağlama
Geliştirici, şablon raporlarını, veri kaynaklarını hazırlar ve bir Bağlantı API'si URL'si biçimlendirir. Geliştiriciler için tipik iş akışı aşağıdaki gibidir:
- Boş bir rapor mu kullanacağınıza, Looker Studio tarafından sağlanan varsayılan rapor şablonunu mu kullanacağınıza, yoksa şablon olarak hizmet verecek bir Looker Studio raporu mu oluşturacağınıza karar verin. Buna şablon veri kaynaklarının yapılandırılması da dahildir.
- Özel kullanım alanınız için bir Bağlantı API'si URL'si biçimlendirin. Varsa rapor şablonunu ve rapor adı, veri kaynağı adı ve veri kaynağı yapılandırmaları dahil diğer parametreleri belirtin.
- Kullanıcıları rapora yönlendirmek için Linking API URL'sini kullanın.
Bağlantı oluşturma API'si kullanıcı deneyimi
Kullanıcı, bir Bağlantı API'si URL'sini takip eder. Bu URL, geliştirici tarafından doğru şekilde yapılandırılırsa kullanıcıyı, erişimi olan verileri görüntülemesine ve bu verilerle etkileşimde bulunmasına olanak tanıyan bir Looker Studio raporuna yönlendirir. Tipik bir kullanıcı deneyimi şu şekilde olabilir:
- Kullanıcı bir tarayıcıda, Linking API'yle entegre edilmiş bir hizmeti ziyaret eder.
- Harekete geçirici mesaj, kullanıcıyı Looker Studio'da verilerini görüntülemek için bir bağlantıyı tıklamaya davet eder.
- Kullanıcı, bağlantıyı takip eder ve Looker Studio raporuna yönlendirilir. Rapor yüklenir ve kullanıcı, verilerini görüntüleyebilir ve verilerle etkileşim kurabilir.
- Kullanıcı, "Düzenle ve paylaş"ı tıklar. Rapor, Looker Studio hesabına kaydedilir.
- Kullanıcı artık kendi rapor kopyası üzerinde tam erişime ve denetime sahiptir. Kullanıcılar diledikleri zaman görüntüleyebilir, düzenleyebilir ve paylaşabilirler.
Koşullar
Bağlantı API'si URL'sinin beklendiği gibi çalıştığından emin olmak için aşağıdakiler gereklidir:
- Şablon olarak sunulan bir rapor. Sağlanmazsa Looker Studio tarafından sağlanan boş bir rapor veya varsayılan rapor kullanılabilir.
- Bağlantı API'si URL'sinin kullanıcıları, şablon raporunu en azından görüntüleme erişimine sahip olmalıdır. Raporda kullanılan veri kaynaklarının türüne ve Linking API aracılığıyla sağlanan yapılandırmaya bağlı olarak, kullanıcıların veri kaynaklarını görüntüleme erişimine de ihtiyacı olabilir. Ayrıntılar için Şablon izinleri bölümüne bakın.
- Her veri kaynağının Bağlayıcı türü, Linking API aracılığıyla yapılandırmayı desteklemelidir. Desteklenen bağlayıcıların listesi için Bağlayıcı referansı bölümüne bakın.
- Linking API URL'sinin kullanıcıları, Linking API URL'sinde yapılandırılan verilere erişebilmelidir. Kullanıcının temel verilere erişimi yoksa bağımlı rapor bileşenlerinde hata gösterilir.
URL parametreleri
Bağlantı API'si URL'si aşağıdaki biçimde olmalıdır:
https://lookerstudio.google.com/reporting/create?parameters
URL'nin bir web tarayıcısı bağlamında kullanılması beklenir. Bu kullanım, genellikle kullanıcının bir bağlantıyı tıklaması veya URL'ye yönlendirilmesidir. Ayrıca, rapor yerleştirmek için de kullanılabilir.
Örnek URL
Aşağıda örnek bir Bağlantı Oluşturma API'si URL'si gösterilmektedir. Rapor adı belirlenir ve tek bir BigQuery veri kaynağı yapılandırılır:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.connector=bigQuery
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
Belirli URL parametreleri zorunlu, bazıları ise isteğe bağlıdır. Aşağıda, Linking API URL'sini tanımlamak için kullanılan parametrelerin bir listesi verilmiştir:
Kontrol parametreleri
Kontrol parametreleri, Bağlantı API'si URL'si ile görüntülendiğinde raporun durumunu belirler.
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Şablon rapor kimliği. Looker Studio, belirtilen raporu açar ve yapılandırır. Kimliğin nasıl bulunacağı hakkında ayrıntılı bilgi için Rapor Kimliği başlıklı makaleyi inceleyin. Belirtilmemişse boş bir rapor veya varsayılan rapor şablonu kullanılır. Ayrıntılar için Boş veya varsayılan bir rapor kullanma bölümüne bakın. | |
İsteğe bağlı. Raporda yüklenecek ilk sayfanın kimliği. Belirtilmemişse varsayılan olarak raporun ilk sayfasını açar. | |
İsteğe bağlı. İlk rapor modu.
view veya
edit değerlerinden biri. Belirtilmemişse varsayılan olarak view değerine ayarlanır.
|
|
İsteğe bağlı. Bilgi/hata ayıklama iletişim kutusunun görünürlüğü. İletişim düğmesini göstermek için true olarak ayarlayın. Belirtilmemişse varsayılan olarak false değerine ayarlanır. Daha fazla bilgi edinmek için
Yapılandırma sorunlarını giderme sayfasına bakın.
|
Örnek
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&c.pageId=g7u8s9
&c.mode=edit
&r.reportName=MyNewReport
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
Rapor parametreleri
Rapor parametreleri rapor özelliklerini geçersiz kılar.
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Rapor adını ayarlar. Belirtilmemesi halinde varsayılan olarak şablon raporu adı kullanılır. | |
İsteğe bağlı. Google Analytics Ölçüm Kimlikleri'ni Rapor kullanımını ölç olarak ayarlar. Birden çok kimliği ayırmak için virgül kullanın.
|
|
İsteğe bağlı. Google Analytics Ölçüm Kimlikleri şablon raporunu kullanmak için değeri
|
Örnek
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&r.measurementId=G-XXXXXXXXXX
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.projectId=project-1234
&ds.ds0.type=TABLE
&ds.ds0.datasetId=456
&ds.ds0.tableId=789
Veri kaynağı parametreleri
Veri kaynağı parametreleri, şablon raporunda bir veri kaynağı yapılandırması ve veri kaynakları için erişilecek veriler tanımlamanıza olanak tanır.
alias
, mevcut bir rapordaki bir veri kaynağına referans vermek için kullanılır. Takma ad kullanmak, şablon raporuna bir veri kaynağı eklendiğinde/rapordan kaldırıldığında geriye dönük uyumluluğa olanak tanır.
alias
veri kaynağını nasıl bulacağınızla ilgili ayrıntılar için Veri kaynağı takma adı başlıklı makaleyi inceleyin.
Veri kaynağı parametreleri
Aşağıdaki parametreler tüm bağlayıcı türlerinde ortaktır:
Ad | Açıklama |
---|---|
İsteğe bağlı. Veri kaynağının adını ayarlar.
|
|
İsteğe bağlı. Şablon veri kaynağı adını kullanmak için
|
|
İsteğe bağlı.
Veri kaynağının bağlayıcı türü. Desteklenen bağlayıcı türleri hakkında daha fazla bilgi için Bağlayıcı referansı bölümüne bakın. Ayarlanırsa bağlayıcı türü için gerekli tüm bağlayıcı parametreleri, Linking API URL'sinde belirtilmelidir. Böylece, şablon veri kaynağı yapılandırması tümüyle değiştirilir. Belirtilmemesi durumunda, Linking API URL'sinde bağlayıcı türü için sıfır veya daha fazla bağlayıcı parametresi belirtilebilir. Bağlantı API'si URL'sinde sağlanmayan parametreleri belirtmek için şablon veri kaynağı yapılandırması kullanılır. Şablon veri kaynağının bağlayıcı türünü tanımlama hakkında ayrıntılı bilgi için Bağlayıcı türü bölümünü inceleyin. Bir şablon veri kaynağı yapılandırmasının tamamen değiştirilip değiştirilmediğini veya belirtilmemiş parametreleri güncellemek için kullanılıp kullanılmayacağını |
|
İsteğe bağlı.
Veri kaynağı alanlarını yenilemek ve rapor bileşenlerini yeni alan seçimleriyle güncellemek amacıyla Linking API aracılığıyla belirtilen veri kaynağı yapılandırmasını kullanmak için Veri kaynağı alanlarını şablon raporundan değiştirmeden bırakmak için Belirtilmezse varsayılan ayarlar bağlayıcı türüne göre değişir. Varsayılan davranışı geçersiz kılmak isterseniz bağlayıcıya özel varsayılanlar için Bağlayıcı referansı sayfasını inceleyin. refreshFields kullanırken dikkat edilmesi gereken noktalar:
|
|
Zorunludur. Bağlayıcı türüne ait veri kaynağı yapılandırması. Veri kaynağı oluşturmak için kullanılan bağlayıcıyı tanımlamayla ilgili ayrıntılar için Bağlayıcı türü bölümüne bakın. Her bir bağlayıcı türü için kullanılabilen veri kaynağı parametreleriyle ilgili ayrıntılar için Bağlayıcı referansı bölümüne bakın. |
Değiştirme ve güncelleme - Veri kaynağı yapılandırmaları
Veri kaynağı parametrelerini ayarlarken Linking API URL'sinde ds.connector
parametresinin bulunması veya görünmemesi, şablon veri kaynağı yapılandırmasını sırasıyla değiştirme veya güncelleme amacını gösterir.
Aşağıdaki tabloda, ds.connector
parametresinin, bir şablon veri kaynağı yapılandırmasının tamamen değiştirilmesini veya belirtilmemiş parametreleri güncellemek için kullanılmasını nasıl etkilediği ayrıntılı bir şekilde açıklanmıştır:
ds.connector ayarlandı mı? |
Beklenen yapılandırma ve davranış | Tipik kullanım |
---|---|---|
Evet |
Değiştir. Şablon veri kaynağı yapılandırması, Linking API URL'sinde belirtilen veri kaynağı parametreleri kullanılarak tamamen değiştirilir. Bağlayıcı türü için gerekli tüm parametreleri belirtmeniz gerekir. ds.connector ayarlandığında gerekli parametreler bölümüne bakın.
|
|
Hayır | Güncelle. Bağlantı API'si URL'sinde sağlanmayan parametreleri belirtmek için şablon veri kaynağı yapılandırması kullanılır. Aksi belirtilmedikçe bağlayıcı türüne yönelik tüm bağlayıcı parametreleri isteğe bağlıdır.
Bu işlem, Linking API URL'sini basitleştirir ve şablon veri kaynağı yapılandırmasına aşina olup yalnızca parametrelerin bir alt kümesini geçersiz kılmak istiyorsanız genellikle önerilir. |
|
ds.connector
ayarlandığında gerekli parametreler
Bir veri kaynağının ds.connector
parametresi belirtilirse veri kaynağı için Zorunlu olarak belirtilen tüm bağlayıcı parametreleri belirtilmelidir. Veri kaynağının ds.connector
parametresi belirtilmemişse tüm bağlayıcı parametreleri (zorunlu olarak belirtilenler dahil) aksi belirtilmedikçe isteğe bağlı olarak değerlendirilebilir.
Örnekler
Raporu tek bir BigQuery veri kaynağıyla (ds0
) yapılandırır ve veri kaynağı yapılandırmasını tamamen değiştirir:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
Raporda tek bir veri kaynağı varsa veri kaynağı takma adı atlanabilir. Yukarıdaki URL aşağıdaki şekilde basitleştirilebilir:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.datasourceName=MyNewDataSource
&ds.connector=bigQuery
&ds.type=TABLE
&ds.projectId=bigquery-public-data
&ds.datasetId=samples
&ds.tableId=shakespeare
Bir raporu tek bir BigQuery veri kaynağıyla (ds0
) yapılandırır ve yalnızca veri kaynağının faturalandırma projesi kimliğini günceller:
https://lookerstudio.google.com/reporting/create?
c.reportId=12345
&r.reportName=MyNewReport
&ds.ds0.billingProjectId=my-billing-project
Bir BigQuery veri kaynağı (ds0
) ve bir Google Analytics veri kaynağı (ds1
) olmak üzere iki veri kaynağı içeren bir raporu yapılandırır. BigQuery veri kaynağı yapılandırmasının
tamamıyla değiştirilir. Google Analytics yapılandırması tek bir parametreyi günceller ve belirtilmeyen tüm bağlayıcı parametreleri için ds1
şablon veri kaynağını kullanır:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&r.reportName=MyNewReportWithMultipleDataSources
&ds.ds0.datasourceName=MyNewDataSource
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
&ds.ds1.viewId=92320289
Oluşturma ve Ekleme
Aynı veri kaynağının birden fazla raporda bulunması bazen yararlı olabilir. Bu nedenle, veri kaynağında yapılan güncellemelerin tüm raporları birlikte etkilemesi gerekir. Bağlantı API'si kullanarak rapor oluştururken, aşağıdaki tüm koşulların karşılandığından emin olarak şablon raporunuzdan bir veri kaynağını yeniden ekleyebilirsiniz:
- Veri kaynağı yeniden kullanılabilir (yerleştirilmiş ve yeniden kullanılabilir veri kaynakları bölümüne bakın)
- URL, veri kaynağına takma adla başvurmuyor
- URL, joker karakter takma adı kullanmıyor (Veri kaynağı takma adı joker karakter bölümüne bakın)
Linking API ile yeni bir veri kaynağı oluşturulduğunda, URL'yi tıklayan kullanıcının kimlik bilgileri kullanılır. Bu, kullanıcının temel verilere erişimi olması gerektiği, aksi takdirde bağlantının çalışmayacağı anlamına gelir. Veri kaynağını yeni oluşturulan rapora yeniden ekleyerek kullanıcıların yeni raporlarındaki verilere erişmeye devam edebilmesi için kimlik bilgilerini koruyabilirsiniz.
Veri kaynağı takma adı joker karakteri
Bir Linking API parametresini birden fazla veri kaynağına uygulamak için veri kaynağı takma adının yerine ds.*
joker karakter takma adı kullanılabilir.
Bu, URL'nizden yinelenen parametreleri kaldırmak için yararlı olabilir. Örneğin, üç BigQuery veri kaynağının ekli olduğu bir şablonunuz varsa ve her birindeki projectId
ve datasetId
değerlerini değiştirip tableId
değerini korumak istiyorsanız şablonu şu şekilde yazabilirsiniz:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.ds1.projectId=client-project
&ds.ds1.datasetId=client-dataset
&ds.ds2.projectId=client-project
&ds.ds2.datasetId=client-dataset
&ds.ds3.projectId=client-project
&ds.ds3.datasetId=client-dataset
Ayrıca, ds.*
joker karakteriyle şu eşdeğer URL'yi de kullanabilirsiniz:
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
Linking API'ye sağlanan ve ds.*
joker karakterini kullanmayan parametreler, diğer parametrelere göre önceliklidir. Yukarıdaki örnekte, joker karakterdeki değeri geçersiz kılmak için belirli bir veri kaynağı takma adı ekleyebilirsiniz.
https://lookerstudio.google.com/reporting/create?
c.reportId=7890
&ds.*.projectId=client-project
&ds.*.datasetId=client-dataset
&ds.ds1.datasetId=client-dataset
Daha genel olarak, parametrenin öncelik sırası şu şekildedir:
- Belirli bir takma adla (
ds.ds1.datasetId
) verilen bir parametre - Joker karakter (
ds.*.datasetId
) kullanılarak sağlanan bir parametre - ds.connector sağlanmamışsa şablon veri kaynağından türetilen bir değer (Değiştirme ve güncelleme bölümüne bakın)
- İsteğe bağlıysa parametre için varsayılan değer.
Bağlayıcı referansı
Linking API aşağıdaki bağlayıcıları ve yapılandırmaları destekler. Her bir bağlayıcı için, kullanılabilir veri kaynağı parametrelerinin listesi sağlanmıştır.
BigQuery
BigQuery bağlayıcısı, sorgulanacak tablonun Tablo Kimliğini sağladığınız TABLE
sorgusu ve tabloyu sorgulamak için SQL ifadesi sağladığınız CUSTOM_QUERY
olmak üzere iki tür sorguyu destekler.
TABLE sorguları
type
, TABLE
olarak ayarlandığında ve sorgulanacak tablonun kimliğini sağladığınızda aşağıdaki parametreler geçerli olur.
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. BigQuery bağlayıcısı için bigQuery olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan BigQuery yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Sorgunun türü. TABLE olarak ayarlayın. |
|
Zorunlu** Sorgulanacak tablonun Proje Kimliği. | |
Zorunlu** Sorgulanacak tablonun Veri Kümesi Kimliği. | |
Zorunlu** Sorgulanacak tablonun Tablo Kimliği. Parçalı tablolar: Kırpılmış tarih tabloları sorgulanırken * (joker karakter) veya YYYYMMDD son eki desteklenir.Bir tablo Google Analytics, Firebase Analytics veya Firebase Crashlytics olarak tanımlanırsa varsayılan alan şablonu seçilir. Alan şablonu tablosuyla ilgili parametrelere bakın. |
|
İsteğe bağlı. Faturalandırma için kullanılacak Projenin kimliği. Ayarlanmazsa projectId kullanılır. |
|
İsteğe bağlı. Tablo bölümlendirilmişse ve bölümlendirme sütununu tarih aralığı boyutu olarak kullanmak istiyorsanız true olarak ayarlayın. Bu, yalnızca zamana dayalı bölümlendirme (ör. zamana dayalı bölümlendirme sütunu veya _PARTITIONTIME sözde sütunu kullanma) için geçerlidir ve tam sayı aralığı bölümlendirilmiş tablolarda işe yaramaz. Belirtilmemişse varsayılan olarak false değerine ayarlanır. Daha fazla bilgi için
Bölümlendirilmiş tablolara giriş bölümüne bakın. |
|
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Google Analytics, Firebase Analytics ve Crashlytics için alan şablonu
Google Analytics, Firebase Analytics veya Firebase Crashlytics olarak tanımlanan tablolarda, alan şablonunu ayarlamak için ek parametreler kullanılabilir. Belirtilmemesi durumunda varsayılan şablon seçilir.
Ad | Açıklama |
---|---|
İsteğe bağlı. Kullanılacak Google Analytics alanları şablonu. Yalnızca Google Analytics için BigQuery Export tablosu sorgulanırken geçerlidir. Şunlardan biri: ALL , SESSION , HITS . Google Analytics tabloları için belirtilmediyse varsayılan olarak ALL olur. |
|
İsteğe bağlı. Kullanılacak Firebase Analytics alanları şablonu. Yalnızca Firebase Analytics için BigQuery Export tablosu sorgulanırken geçerlidir.
Yalnızca EVENTS olarak ayarlanabilir. Firebase Analytics tabloları için belirtilmediyse varsayılan olarak EVENTS olur. |
|
Kullanılacak Firebase Crashlytics alan şablonu. Yalnızca
DEFAULT olarak ayarlanabilir. Yalnızca Firebase Crashlytics tablosu için BigQuery Export tablosu sorgulanırken geçerlidir. Firebase Crashlytics tabloları için,
belirtilmezse varsayılan olarak DEFAULT değeri kullanılır. |
ÖZEL sorgular
type
, CUSTOM_QUERY
olarak ayarlandığında ve bir tabloyu sorgulamak için SQL ifadesi sağladığınızda aşağıdaki parametreler geçerli olur.
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. BigQuery bağlayıcısı için bigQuery olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan BigQuery yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Sorgunun türü. CUSTOM_QUERY olarak ayarlayın. |
|
Zorunlu** Çalıştırılacak SQL sorgusu. | |
İsteğe bağlı. Faturalandırma için kullanılacak Projenin kimliği. Ayarlanmazsa projectId kullanılır. projectId belirtilmezse sorgulanan tablonun projesi kullanılır. |
|
İsteğe bağlı. SQL sorgusuna uygulanacak kalıp ve değiştirme dizelerinin virgülle ayrılmış listesi. Dize değiştirme yalnızca bir kalıp eşleşmesi varsa uygulanır. Desen ve yedek dize çiftlerini ayırmak için virgül kullanın. Örneğin, |
|
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnekler
Sorgunun bir tablo kimliğiyle tanımlandığı TABLE
türü yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=shakespeare
&ds.ds0.billingProjectId=myProject
Joker karakter sonekini kullanarak parçalanmış bir tarih tablosunu sorgulamak için TABLE
türü yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=price-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=stock_*
YYYYMMDD
son ekini kullanarak parçalanmış bir tarihi tabloyu sorgulamak için TABLE
türü yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=price-data
&ds.ds0.datasetId=samples
&ds.ds0.tableId=stock_YYYYMMDD
SESSION
alanları şablonunu kullanarak Google Analytics için BigQuery Export tablosunu sorgulamak amacıyla TABLE
türü yapılandırma:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=my-gabq-project
&ds.ds0.datasetId=1234567
&ds.ds0.tableId=ga_sessions_YYYYMMDD
&ds.ds0.gaTemplateLevel=SESSION
Kullanım süresine göre bölümlendirilmiş bir tabloyu sorgulamak ve bölümlendirme sütununu tarih aralığı boyutu olarak kullanmak için TABLE
türü yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=TABLE
&ds.ds0.projectId=acme-co-logs
&ds.ds0.datasetId=logs
&ds.ds0.tableId=logs_table
&ds.ds0.isPartitioned=true
Sorgulamalarının bir SQL ifadesiyle tanımlandığı CUSTOM_QUERY
türü yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.connector=bigQuery
&ds.ds0.type=CUSTOM_QUERY
&ds.ds0.projectId=bigquery-public-data
&ds.ds0.sql=SELECT%20word%2C%20word_count%20FROM%20%60bigquery-public-data.samples.shakespeare%60
&ds.ds0.billingProjectId=myProject
Yalnızca SQL ifadesinin güncellendiği ve yapılandırmanın geri kalanı için şablon veri kaynağının kullanıldığı bir CUSTOM_QUERY
türü yapılandırma:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.sql=SELECT%20corpus%20FROM%20%60bigquery-public-data.samples.shakespeare%60
Şablon veri kaynağının SQL ifadesinin sqlReplace
kullanılarak güncellendiği CUSTOM_QUERY
türü yapılandırma:
https://lookerstudio.google.com/reporting/create?
c.reportId=123abc
&ds.ds0.sqlReplace=bigquery-public-data,new-project,samples,new-dataset
# The following shows a template query before and after sqlReplace is applied.
#
# Template data source custom query:
# SELECT word, word_count FROM big-query-public-data.samples.shakespeare
# INNER JOIN
# SELECT word, word_count FROM big-query-public-data.samples.raleigh
#
# New data source custom query with sqlReplace applied:
# SELECT word, word_count FROM new-project.new-dataset.shakespeare
# INNER JOIN
# SELECT word, word_count FROM new-project.new-dataset.raleigh
Cloud Spanner
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Cloud Spanner bağlayıcısı için cloudSpanner değerine ayarlayın.Ayarlanırsa veri kaynağını sağlanan Cloud Spanner yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Proje Kimliği. | |
Zorunlu** Örnek kimliği. | |
Zorunlu** Veritabanı Kimliği. | |
Zorunlu** Çalıştırılacak SQL sorgusu. | |
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır.
Ayrıntılar için refreshFields bölümüne bakın. |
Örnek
SQL ifadesi içeren bir Cloud Spanner yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=456def
&ds.ds1.connector=cloudSpanner
&ds.ds1.projectId=myProject
&ds.ds1.instanceId=production
&ds.ds1.datasetId=transactions
&ds.ds1.sql=SELECT%20accountId%2C%20date%2C%20revenue%20FROM%20sales%3B
Topluluk Bağlayıcıları
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Topluluk Bağlayıcısı için community olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Topluluk Bağlayıcısı yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Topluluk Bağlayıcısı
connectorId (deploymentId olarak da bilinir).
| |
İsteğe bağlı. Topluluk bağlayıcısının bağlayıcı yapılandırması tarafından tanımlanan, bağlayıcıya özel ek parametreler. | |
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnek
state
ve city
yapılandırma parametreleriyle topluluk bağlayıcısına bağlanın:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=community
&ds.ds5.connectorId=AqwqXxQshl94nJa0E0-1MsZXQL0DfCsJIMWk7dnx
&ds.ds5.state=CA
&ds.ds5.city=Sacramento
Google Analytics
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Google Analytics bağlayıcısı için googleAnalytics olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Google Analytics yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Hesap Kimliği. | |
Zorunlu** Mülk Kimliği. | |
Görünüm Kimliği.Universal Analytics mülkleri için zorunludur**. Google Analytics 4 mülkleri için ayarlamayın. |
|
İsteğe bağlı. Belirtilmemişse varsayılan olarak false değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnekler
Universal Analytics mülkü için Google Analytics yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=789ghi
&ds.ds2.connector=googleAnalytics
&ds.ds2.accountId=54516992
&ds.ds2.propertyId=UA-54516992-1
&ds.ds2.viewId=92320289
Google Analytics 4 mülkü için Google Analytics yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=789ghi
&ds.ds2.connector=googleAnalytics
&ds.ds2.accountId=54516992
&ds.ds2.propertyId=213025502
Google Cloud Storage
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. googleCloudStorage
Google Cloud Storage bağlayıcısı olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Google Cloud Storage yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Yol türü. Belirli bir yoldaki tüm dosyaları seçmek için FILE tuşunu, tek bir dosya seçmek için FOLDER tuşunu kullanın. |
|
Zorunlu** pathType FILE ise dosya yolu (ör. MyBucket/MyData/MyFile.csv) veya pathType FOLDER ise klasör yolu (ör. *MyBucket/MyData). |
|
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır.
Ayrıntılar için refreshFields bölümüne bakın. |
Örnek
Tek bir dosya için Google Cloud Storage yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FILE
&ds.ds50.path=MyBucket%2FMyData%2FMyFile.csv
Yoldaki tüm dosyalar için bir Google Cloud Storage yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=231908kpf
&ds.ds50.connector=googleCloudStorage
&ds.ds50.pathType=FOLDER
&ds.ds50.path=MyBucket%2FMyData
Google E-Tablolar
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Google E-Tablolar bağlayıcısı için değeri googleSheets olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Google E-Tablolar yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** E-tablo kimliği. | |
Zorunlu** Çalışma sayfası kimliği. | |
İsteğe bağlı. İlk satırı başlık olarak kullanmak için true olarak ayarlayın.
Belirtilmemişse varsayılan olarak true değerine ayarlanır. Sütun başlıkları benzersiz olmalıdır. Boş başlıklı sütunlar veri kaynağına eklenmez.
|
|
İsteğe bağlı. Gizli hücreleri dahil etmek için true olarak ayarlayın.
Belirtilmemişse varsayılan olarak true değerine ayarlanır. |
|
İsteğe bağlı. Filtrelenmiş hücreleri dahil etmek için true olarak ayarlayın.
Belirtilmemişse varsayılan olarak true değerine ayarlanır. |
|
İsteğe bağlı. Aralık, ör. A1:B52. | |
İsteğe bağlı. Belirtilmemişse varsayılan olarak true değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnekler
Google E-Tablolar yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
İlk satırın başlık olarak kullanıldığı, gizli ve filtrelenmiş hücrelerin dahil edildiği bir Google E-Tablolar yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
&ds.ds3.hasHeader=true
&ds.ds3.includeHiddenCells=true
&ds.ds3.includeFilteredCells=true
Aralık (A1:D20) içeren bir Google E-Tablolar yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=101112jkl
&ds.ds3.connector=googleSheets
&ds.ds3.spreadsheetId=1Qs8BdfxZXALh6vX4zrE7ZyGnR3h5k
&ds.ds3.worksheetId=903806437
&ds.ds3.range=A1%3AD20
Looker
Parametre adı | Açıklama |
---|---|
İsteğe bağlı.
Looker bağlayıcısı için looker olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Looker yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Looker örneği URL'si. | |
Zorunlu** Looker modeli. | |
Zorunlu** Looker Explore. | |
İsteğe bağlı. Belirtilmemişse varsayılan olarak false değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnek
Looker Explore sorgusuna bağlanma:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=looker
&ds.ds5.instanceUrl=my.looker.com
&ds.ds5.model=thelook
&ds.ds5.explore=orders
Search Console
Parametre adı | Açıklama |
---|---|
İsteğe bağlı. Search Console bağlayıcısı için searchConsole olarak ayarlayın.Ayarlanırsa veri kaynağını sağlanan Search Console yapılandırmasıyla değiştirir. Değiştirme ve güncelleme bölümüne göz atın. |
|
Zorunlu** Site URL'si. Alan mülkü için sc-domain\: önekini kullanın. |
|
Zorunlu** Tablo türünü ayarlar. SITE_IMPRESSION veya URL_IMPRESSION değerlerinden biri olabilir. |
|
Zorunlu** Arama türünü ayarlar. WEB , IMAGE , VIDEO veya NEWS değerlerinden biri olabilir. |
|
İsteğe bağlı. Belirtilmemişse varsayılan olarak false değerine ayarlanır. Ayrıntılar için refreshFields bölümüne bakın. |
Örnek
Bir URL ön ek mülkü için Search Console yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
&ds.ds5.connector=searchConsole
&ds.ds5.siteUrl=https%3A%2F%2Fwww.example.com%2Fwelcome
&ds.ds5.tableType=SITE_IMPRESSION
&ds.ds5.searchType=WEB
Alan mülkü için Search Console yapılandırması:
https://lookerstudio.google.com/reporting/create?
c.reportId=161718pqr
ds.ds5.connector=searchConsole
&ds.ds5.siteUrl=sc-domain%3Aexample.com
&ds.ds5.tableType=SITE_IMPRESSION
&ds.ds5.searchType=WEB
Şablon izinleri
Kullanıcılara en iyi kullanıcı deneyimini sunmak amacıyla şablon raporunuz ve ilişkili veri kaynakları için rapor erişim izinlerini doğru şekilde ayarlamak önemlidir. Gerekli izinler, rapor şablonunun yerleştirilmiş ve yeniden kullanılabilir veri kaynaklarını kullanıp kullanmadığına ve Linking API yapılandırmasının bir veri kaynağı yapılandırmasını değiştirecek veya güncelleyecek şekilde ayarlanıp ayarlanmadığına bağlıdır.
Aşağıdaki tabloda, şablon veri kaynaklarına ve Bağlantı API'si yapılandırmasına bağlı olarak en iyi kullanıcı deneyimi için önerilen veri kaynağı erişimi sunulmuştur:
Veri kaynağı türü | Veri kaynağı için API yapılandırmasını bağlama | Veri kaynağı izinleri için öneri | Notlar |
---|---|---|---|
Yerleştirilme tarihi | Değiştir | Yok - Görüntüleme erişimi rapordan devralınır. | Kullanıcının şablon raporuna görüntüleme erişimi varsa yerleştirilmiş veri kaynaklarına otomatik olarak görüntüleme erişimi verilir. |
Yerleştirilme tarihi | Güncelle | Yok - Görüntüleme erişimi rapordan devralınır. | Kullanıcının şablon raporuna görüntüleme erişimi varsa yerleştirilmiş veri kaynaklarına otomatik olarak görüntüleme erişimi verilir. |
Yeniden kullanılabilir | Değiştir | Kullanıcıların görüntüleme erişimine ihtiyacı yoktur. | Veri kaynağı yapılandırmasının tamamı Linking API aracılığıyla değiştirildiğinden görüntüleme erişimi gerekli değildir. |
Yeniden kullanılabilir | Güncelle | Kullanıcının görüntüleme erişimi olması gerekir. | Linking API'nin şablon veri kaynağındaki yapılandırmayı okuyabilmesi ve kullanabilmesi için veri kaynağına görüntüleme erişimi gerekir. Kullanıcıların görüntüleme erişimi yoksa raporu yüklerken hatayla karşılaşırlar. |
Boş veya varsayılan bir rapor kullan
Boş bir rapor veya varsayılan rapor kullanmak için Linking API'nizi aşağıdaki gibi yapılandırın:
Rapor türü | reportId kontrol parametresini ayarlama |
Veri kaynağı ( ) parametrelerini ayarlayın. |
Notlar |
---|---|---|---|
Boş rapor | Hayır | Hayır | |
Varsayılan rapor | Hayır | Evet | Varsayılan rapor Looker Studio tarafından sağlanır. Varsayılan raporda tek bir yerleşik veri kaynağı olduğundan, varsayılan rapor için veri kaynağı parametrelerini belirtirken veri kaynağı takma adı kullanmak gerekli değildir. |
Aşağıdaki örneklerde, boş veya varsayılan rapor kullanan çeşitli Bağlantı API'si URL'leri gösterilmektedir.
Rapor oluşturma iş akışını boş bir raporla başlatın:
https://lookerstudio.google.com/reporting/create
Rapor oluşturma iş akışını boş bir raporla başlatın ve rapor adını ayarlar:
https://lookerstudio.google.com/reporting/create?r.reportName=MyNewReport
Google E-Tablolar bağlayıcı yapılandırmasıyla varsayılan rapor şablonunu kullanın:
https://lookerstudio.google.com/reporting/create?
ds.connector=googleSheets
&ds.spreadsheetId=1Q-w7KeeJj1jk3wFcFm4NsPlppNscs0CtHf_EP9fsYOo
&ds.worksheetId=0
Rapor yerleştirme
Bağlantı API'si ile oluşturulan bir raporu yerleştirmek için URL parametrelerini ayarlayın ve /embed/
yolunu ekleyin. Bağlantı API'si yerleştirme URL'si aşağıdaki biçimde olmalıdır:
https://lookerstudio.google.com/embed/reporting/create?parameters
Kimlikleri ve takma adları bulma
Rapor kimliği
Rapor kimliğini bulmak için:
- Şablon olarak kullanmak istediğiniz raporu açın. Raporun URL'sini denetleyin.
reporting/
ile/page
arasındaki kısım rapor kimliğidir. Örneğin, aşağıdaki URL'de0B_U5RNpwhcE6SF85TENURnc4UjA
rapor kimliğidir:
https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M
Veri kaynağı takma adı
Bir raporun birden fazla veri kaynağı olabilir. Bir veri kaynağına takma adıyla referans verilmelidir.
Veri kaynağı takma adını bulmak için:
- Raporu düzenleyin.
- Araç çubuğundan Kaynak > Eklenen veri kaynaklarını yönetin'i seçin.
- Her bir veri kaynağı için takma ad bilgilerini bulmak üzere Takma ad sütununu inceleyin.
Bir Veri Kaynağı eklendiğinde veya kaldırıldığında geriye dönük uyumluluğu sağlamak için takma ad adlarını düzenleyebilirsiniz.
Bağlayıcı türü
Bir raporda, her biri bir bağlayıcı yapılandırılarak oluşturulan birden çok veri kaynağı olabilir. Veri kaynağı oluştururken kullanılan bağlayıcı türünü bulmak için:
- Raporu düzenleyin.
- Araç çubuğundan Kaynak > Eklenen veri kaynaklarını yönetin'i seçin.
- Veri kaynağı oluşturmak için kullanılan bağlayıcıyı tanımlamak üzere Bağlayıcı Türü sütununu inceleyin.
İpuçları ve sorun giderme
Sorun yaşıyorsanız olası sorunları ve yaygın yanlış yapılandırmaları tanımlamak için aşağıdaki ayrıntıları inceleyin.
Hata ayıklama iletişim kutusu
Looker Studio tarafından yorumlandığı şekliyle Bağlantı API'si yapılandırmasını incelemek için hata ayıklama iletişim kutusunu kullanın. API ile ilgili sorunları ayıklamaya yardımcı olabilir.
- Linking API URL'si ayrıştırılırken bir hatayla karşılaşıldığında hata hakkında ayrıntıların yer aldığı bir iletişim kutusu otomatik olarak gösterilir.
- Bir hata oluştuğunda otomatik olarak herhangi bir iletişim kutusu gösterilmediğinde raporun sağ üst köşesindeki bilgi düğmesini bulun. Hata ayıklamayla ilgili ek bilgi için tıklayın.
- Bilgi düğmesi yoksa herhangi bir Bağlantı API'si URL'sinin sonuna
&c.explain=true
parametresini ekleyerek düğmeyi etkinleştirebilirsiniz.
İzinler
Veri kaynağı türleri ve Linking API yapılandırması için doğru şablon izinlerine sahip olduğunuzdan emin olun. Ayrıntılar için Şablon izinleri bölümüne bakın.
Güncelle ve değiştir
Bir veri kaynağı yapılandırmasını bir veri kaynağı şablonundan güncelliyorsanız uyumlu olduklarından emin olmak için şablon veri kaynağı yapılandırmasını ve Linking API yapılandırmasını inceleyin. Yeni yapılandırmadan elde edilen alanların rapor bileşenleri ve yapılandırmasıyla uyumlu olduğunu onaylayın.
Güncelleme ve değiştirme yaparken tanımlanmamış davranışa sahip geçersiz bir yapılandırma ayarlamak mümkündür. Ayrıntılar için Değiştirme ve güncelleme bölümüne bakın.
Alanları yenile
Bir şablon veri kaynağı için alan adları, türler veya toplamalar yapılandırdıysanız bu değişiklikler, yalnızca ds.refreshFields
parametresinin false
olarak ayarlanması durumunda Connect API'sı yapılandırılmış bir veri kaynağına aktarılır.
Linking API URL'nizin ds.refreshFields
veri kaynağı parametresini inceleyin. Atlanırsa her bir bağlayıcı türüne ilişkin parametrenin varsayılan değerinin kullanım alanınıza uygun olduğunu onaylayın.
Genel olarak şablon veri kaynağında alanlar yapılandırdıysanız ve Linking API aracılığıyla yapılan yeni veri kaynağı yapılandırmalarının her zaman tam olarak aynı alanları vereceğinden eminseniz refreshFields
değerinin false
olarak ayarlanması önerilir.
Örneğin, rapor şablonu oluşturulurken Looker Studio belirli bir veri kaynağı alanını Sayı türünde tanımlar ve bunu Yıl olacak şekilde değiştirirseniz bu alan yapılandırması değişikliği artık şablon veri kaynağının bir parçası olur. Rapor şablonunda düzeltilmiş alanı kullanan tüm grafikler bir Yıl bekler ve grafik zamana dayalıysa aksi halde oluşturulmayabilir. Linking API, tam olarak aynı alanları sağlayan yeni bir veri kaynağı yapılandırması sağlamak için kullanılırsa refreshFields
parametresinin değerine bağlı olarak iki sonuç olur:
true
değerine ayarlanırsa şablon veri kaynağındaki alan yapılandırması aktarılmaz ve aynı alan yapılandırmasına bağlı olan grafikler (ör. Year türünde bir alan beklenirse) yüklenemeyebilir.false
değerine ayarlanırsa şablon veri kaynağındaki alan yapılandırması yeni veri kaynağına aktarılır ve rapor grafikleri aynı yapılandırma ile aynı alanları alır ve başarıyla yüklenir.
Geri bildirim ve destek
Bağlantı API'si sorunlarını bildirmek veya geri bildirimde bulunmak için Sorun İzleyici'yi kullanın. Yardım alma ve soru sormayla ilgili genel kaynaklar için Destek sayfasına bakın.
Değişiklik günlüğü
2023-06-06
- Google Analytics Ölçüm Kimlikleri rapor ayarını yapılandırmak için
r.measurementId
ver.keepMeasurementId
rapor parametreleri eklendi. - Şablon veri kaynağı adının yeniden kullanımını kontrol etmek için
ds.keepDatasourceName
eklendi. - Rapor yerleştirme bölümü eklendi.
- BigQuery bağlayıcısı
sqlReplace
eklendi. Şablon veri kaynağının SQL sorgusunu güncellemek için kalıp ve yedek dizeler belirtebilmenizi sağlar.
2023-05-22
- Looker bağlayıcısı için destek eklendi.
- Topluluk Bağlayıcıları için destek eklendi.
2022-11-21
- Boş rapor kullanma özelliği eklendi. Boş veya varsayılan rapor kullanma bölümünü inceleyin
- İpuçları ve sorun giderme bölümüne
refreshFields
bölümü eklendi.
2022-11-14
- Surveys bağlayıcı referansı, Google Surveys Kullanımdan Kaldırma nedeniyle kaldırıldı.
2022-06-15
- Beta dönemi sona erdi
- Integration API, Linking API olarak yeniden adlandırıldı.
- Linking API beta sürümünden çıktı.
- Belirli bir rapor sayfasına bağlantı verilmesini sağlamak için
pageId
kontrol parametresi eklendi. - Rapor yükleme sırasında rapor durumunu Görüntüle veya Düzenle moduna ayarlamak için
mode
kontrol parametresi eklendi. - Veri kaynağı yapılandırmaları artık tamamen veya kısmen güncellenebilir. Bu davranış,
ds.connector
parametresinin ayarlanıp ayarlanmadığına göre belirlenir. Ayrıntılar için Değiştirme ve güncelleme bölümüne bakın. c.reportId
parametresi kullanılarak rapor şablonu sağlanmazsa artık varsayılan şablon kullanılır.ds.refreshFields
veri kaynağı parametresi eklendi. Bu sayede, bir veri kaynağı yapılandırması yüklenirken veri kaynağı alanlarının yenilenip yenilenmeyeceğini kontrol edebilirsiniz.- BigQuery bağlayıcısı
type
CUSTOM_QUERY
olarak ayarlandığındaprojectId
gerekli değildir.billingProjectId
ayarlanmadığında faturalandırma projesiprojectId
veya sorgulanan tablonun projesine yedeklenir.- Tarihe göre bölümlendirilmiş tablolar için destek eklendi. Bölüm alanını tarih aralığı boyutu olarak kullanmak için
isPartitioned
parametresinitrue
olarak ayarlayın. - Joker karakter veya
YYYYMMDD
tablo son eki kullanılarak tarihe göre bölümlendirilmiş tabloları sorgulama desteği eklendi. - Google Analytics, Firebase Analytics veya Crashlytics tablolarını sorgulama ve alan şablonu seçme desteği eklendi.
- Google E-Tablolar
hasHeader
varsayılan olaraktrue
değerine ayarlanır. Bu değer, web kullanıcı arayüzü varsayılanıyla tutarlıdır.includeHiddenAndFilteredCell
,includeHiddenCells
olarak bölündü veincludeFilteredCells
. Her ikisi de artık web kullanıcı arayüzü varsayılanıyla tutarlı şekilde varsayılan olaraktrue
değerine ayarlanır.
- Search Console bağlayıcısı
propertyType
parametresisearchType
olarak yeniden adlandırıldı.
- Surveys bağlayıcısı
surveyId
artık tek bir anket kimliğini veya anket kimliklerinin virgülle ayrılmış listesini kabul ediyor.
2021-12-16
- Integration API'nin ilk sürümü.
- Mevcut bir rapora bağlantı oluşturmayı ve rapor adını ayarlamayı destekler.
- Birden fazla veri kaynağı yapılandırılabilir ve her bir veri kaynağı adı ayarlanabilir.
- Şu bağlayıcı türleri için destek: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google E-Tablolar, Google Surveys, Search Console.