Bu sayfa, Cloud Translation API ile çevrilmiştir.

Bağlantı API'si

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
`c.reportId`	İ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.
`c.pageId`	İsteğe bağlı. Raporda yüklenecek ilk sayfanın kimliği. Belirtilmemişse varsayılan olarak raporun ilk sayfasını açar.
`c.mode`	İsteğe bağlı. İlk rapor modu. `view` veya `edit` değerlerinden biri. Belirtilmemişse varsayılan olarak `view` değerine ayarlanır.
`c.explain`	İ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

Parametre adı	Açıklama
`r.reportName`	İsteğe bağlı. Rapor adını ayarlar. Belirtilmemesi halinde varsayılan olarak şablon raporu adı kullanılır.
`r.measurementId`	İ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. `r.measurementId` ve `r.keepMeasurementId` belirtilmezse Google Analytics Ölçüm Kimlikleri rapor ayarı varsayılan olarak ayarlanmamış olur. `r.measurementId` ve `r.keepMeasurementId` ayarlanırsa kimliği ayarlamak için `r.keepMeasurementId` öncelikli olur.
`r.keepMeasurementId`	İsteğe bağlı. Google Analytics Ölçüm Kimlikleri şablon raporunu kullanmak için değeri `true` olarak ayarlayın. Belirtilmemişse varsayılan olarak `false` değerine ayarlanır. `r.measurementId` ve `r.keepMeasurementId` belirtilmezse Google Analytics Ölçüm Kimlikleri rapor ayarı varsayılan olarak ayarlanmamış olur. `r.measurementId` ve `r.keepMeasurementId` ayarlanırsa kimliği ayarlamak için `r.keepMeasurementId` öncelikli olur.

r.reportName

İsteğe bağlı. Rapor adını ayarlar. Belirtilmemesi halinde varsayılan olarak şablon raporu adı kullanılır.

r.measurementId

İ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.

r.measurementId ve r.keepMeasurementId belirtilmezse Google Analytics Ölçüm Kimlikleri rapor ayarı varsayılan olarak ayarlanmamış olur. r.measurementId ve r.keepMeasurementId ayarlanırsa kimliği ayarlamak için r.keepMeasurementId öncelikli olur.

r.keepMeasurementId

İsteğe bağlı. Google Analytics Ölçüm Kimlikleri şablon raporunu kullanmak için değeri true olarak ayarlayın. Belirtilmemişse varsayılan olarak false değerine ayarlanır.

Ö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
`ds.alias.datasourceName`	İsteğe bağlı. Veri kaynağının adını ayarlar. `ds.datasourceName` ve `ds.keepDatasourceName` belirtilmezse veri kaynağı adı varsayılan olarak bağlayıcı türünü ve oluşturma zamanını içeren bir adlandırma kuralına uyar (ör. örnekler - 12.12.2021, 22:53). `ds.datasourceName` ve `ds.keepDatasourceName` ayarlanırsa veri kaynağı adını ayarlamak için `ds.datasourceName` öncelikli olur.
`ds.alias.keepDatasourceName`	İsteğe bağlı. Şablon veri kaynağı adını kullanmak için `true` olarak ayarlayın. Belirtilmemişse varsayılan olarak `false` değerine ayarlanır. `ds.datasourceName` ve `ds.keepDatasourceName` belirtilmezse veri kaynağı adı varsayılan olarak bağlayıcı türünü ve oluşturma zamanını içeren bir adlandırma kuralına uyar (ör. örnekler - 12.12.2021, 22:53). `ds.datasourceName` ve `ds.keepDatasourceName` ayarlanırsa veri kaynağı adını ayarlamak için `ds.datasourceName` öncelikli olur.
`ds.alias.connector`	İ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ı `ds.connector` parametresinin nasıl etkilediği hakkında daha fazla bilgi edinmek için Değiştirme ve güncelleme bölümüne bakın.
`ds.alias.refreshFields`	İ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 `true` olarak ayarlayın. `true` genellikle bağlayıcı türünü değiştirirken veya yapılandırma değişikliğinin farklı alanlar getirdiği bağlayıcı türleri için belirtilir (ör. BigQuery veri kaynağı alanları genellikle farklı tablo yapılandırmalarıyla değişir). Veri kaynağı alanlarını şablon raporundan değiştirmeden bırakmak için `false` olarak ayarlayın. `false` genellikle yeni veri yapılandırması tam olarak aynı alanları sağladığında ve şablon veri kaynağında yaptığınız tüm alan değişikliklerini korumayı tercih ettiğinizde belirtilir. 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: `refreshFields`, `false` değerine ayarlanırsa ve Bağlantı API'si aracılığıyla belirtilen veri kaynağı yapılandırması, şablon raporunda kullanılanlardan farklı alanlar oluşturuyorsa kullanıcı, etkilenen bileşenler için bir yapılandırma hatasıyla karşılaşır. `refreshFields`, `true` olarak ayarlandığında şablon veri kaynağındaki alanlarda (ör. ad, tür, toplama vb.) yapılan değişiklikler yeni veri kaynaklarına aktarılmaz. Şablon veri kaynağından alan yapılandırmalarını korumak için `refreshFields` değerini `false` olarak ayarlayın. Şablon veri kaynaklarında tanımlanan hesaplanan alanlar ve Parametreler her zaman yeni oluşturulan veri kaynaklarına kopyalanır ve `refreshFields` değerinden etkilenmez.
`ds.alias.connectorParameters`	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.	Bir veri kaynağının bağlayıcı türünü değiştirirken. Örneğin, şablon raporunda bir BigQuery veri kaynağı yapılandırdıysanız ancak Bağlama API'si aracılığıyla bir E-Tablolar veri kaynağı yapılandırmak istiyorsanız bu işlemi yapabilirsiniz. Bunun için yeni bir bağlayıcı yapılandırmasının tamamen tanımlanması gerekir. Bir veri kaynağının yapılandırmasını garantilemek istediğinizde. Yapılandırmanın değiştirilmesi, şablon veri kaynağından potansiyel olarak bilinmeyen değerlerin kullanılmasını önler.
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.	Yalnızca şablon veri kaynağından farklı parametre değerleri sağlamak istediğinizde ve belirtilmemiş tüm bağlayıcı parametreleri için şablon veri kaynağından yararlandığınızda. Ör. BigQuery veri kaynağı yapılandırmasının yalnızca Faturalandırma Projesi Kimliğini değiştirin ve diğer tüm parametreler için şablon yapılandırmasını kullanın.

`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
`ds.alias.connector`	İ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.
`ds.alias.type`	Zorunlu** Sorgunun türü. `TABLE` olarak ayarlayın.
`ds.alias.projectId`	Zorunlu** Sorgulanacak tablonun Proje Kimliği.
`ds.alias.datasetId`	Zorunlu** Sorgulanacak tablonun Veri Kümesi Kimliği.
`ds.alias.tableId`	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.
`ds.alias.billingProjectId`	İsteğe bağlı. Faturalandırma için kullanılacak Projenin kimliği. Ayarlanmazsa `projectId` kullanılır.
`ds.alias.isPartitioned`	İ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.
`ds.alias.refreshFields`	İ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
`ds.alias.gaTemplateLevel`	İ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.
`ds.alias.firebaseTemplateLevel`	İ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.
`ds.alias.crashlyticsTemplateLevel`	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
`ds.alias.connector`	İ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.
`ds.alias.type`	Zorunlu** Sorgunun türü. `CUSTOM_QUERY` olarak ayarlayın.
`ds.alias.sql`	Zorunlu** Çalıştırılacak SQL sorgusu.
`ds.alias.billingProjectId`	İ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.
`ds.alias.sqlReplace`	İ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, `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.projectId`	Zorunlu** Proje Kimliği.
`ds.alias.instanceId`	Zorunlu** Örnek kimliği.
`ds.alias.databaseId`	Zorunlu** Veritabanı Kimliği.
`ds.alias.sql`	Zorunlu** Çalıştırılacak SQL sorgusu.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.connectorId`	Zorunlu** Topluluk Bağlayıcısı `connectorId` (`deploymentId` olarak da bilinir).
`ds.alias.parameters`	İ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.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.accountId`	Zorunlu** Hesap Kimliği.
`ds.alias.propertyId`	Zorunlu** Mülk Kimliği.
`ds.alias.viewId`	Görünüm Kimliği.Universal Analytics mülkleri için zorunludur**. Google Analytics 4 mülkleri için ayarlamayın.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.pathType`	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.
`ds.alias.path`	Zorunlu** `pathType` `FILE` ise dosya yolu (ör. MyBucket/MyData/MyFile.csv) veya `pathType` `FOLDER` ise klasör yolu (ör. *MyBucket/MyData).
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.spreadsheetId`	Zorunlu** E-tablo kimliği.
`ds.alias.worksheetId`	Zorunlu** Çalışma sayfası kimliği.
`ds.alias.hasHeader`	İ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.
`ds.alias.includeHiddenCells`	İ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.
`ds.alias.includeFilteredCell`	İ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.
`ds.alias.range`	İsteğe bağlı. Aralık, ör. A1:B52.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.instanceUrl`	Zorunlu** Looker örneği URL'si.
`ds.alias.model`	Zorunlu** Looker modeli.
`ds.alias.explore`	Zorunlu** Looker Explore.
`ds.alias.refreshFields`	İ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
`ds.alias.connector`	İ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.
`ds.alias.siteUrl`	Zorunlu** Site URL'si. Alan mülkü için `sc-domain\:` önekini kullanın.
`ds.alias.tableType`	Zorunlu** Tablo türünü ayarlar. `SITE_IMPRESSION` veya `URL_IMPRESSION` değerlerinden biri olabilir.
`ds.alias.searchType`	Zorunlu** Arama türünü ayarlar. `WEB`, `IMAGE`, `VIDEO` veya `NEWS` değerlerinden biri olabilir.
`ds.alias.refreshFields`	İ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ğı (ds) parametrelerini ayarlayın. Notlar

Boş rapor Hayır Hayır

Varsayılan rapor

Hayır

Evet

Rapor türü	`reportId` kontrol parametresini ayarlama	Veri kaynağı (`ds`) 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.

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'de 0B_U5RNpwhcE6SF85TENURnc4UjA rapor kimliğidir:

https://lookerstudio.google.com/reporting/0B_U5RNpwhcE6SF85TENURnc4UjA/page/1M

Looker Studio raporunun URL'sini gösteren tarayıcı adres çubuğu.
Rapor kimliği vurgulanmıştır. — Rapor URL'sinde Rapor Kimliği'ni bulun.

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.

Veri Kaynağı kaynak yönetimi sayfasındaki Veri Kaynaklarının listesi.
Takma ad sütunu vurgulanıyor. — *Veri kaynakları* yönetimi sayfasında veri kaynağı takma adını bulun.

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.

Veri Kaynağı kaynak yönetimi sayfasındaki Veri Kaynaklarının listesi.
Bağlayıcı Türü sütunu vurgulanıyor. — *Veri kaynakları* yönetim sayfasında veri kaynağı bağlayıcı türünü bulun.

İ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 ve r.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ığında projectId gerekli değildir.
- billingProjectId ayarlanmadığında faturalandırma projesi projectId 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 parametresini true 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 olarak true değerine ayarlanır. Bu değer, web kullanıcı arayüzü varsayılanıyla tutarlıdır.
- includeHiddenAndFilteredCell, includeHiddenCells olarak bölündü ve
- includeFilteredCells. Her ikisi de artık web kullanıcı arayüzü varsayılanıyla tutarlı şekilde varsayılan olarak true değerine ayarlanır.
Search Console bağlayıcısı
- propertyType parametresi searchType 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.

Bağlantı API'si

Giriş

Kullanım alanı ve avantajları

İşleyiş şekli

API geliştiricisi iş akışını bağlama

Bağlantı oluşturma API'si kullanıcı deneyimi

Koşullar

URL parametreleri

Kontrol parametreleri

Rapor parametreleri

Veri kaynağı parametreleri

Veri kaynağı parametreleri

Değiştirme ve güncelleme - Veri kaynağı yapılandırmaları

ds.connector ayarlandığında gerekli parametreler

Örnekler

Oluşturma ve Ekleme

Veri kaynağı takma adı joker karakteri

Bağlayıcı referansı

BigQuery

TABLE sorguları

Google Analytics, Firebase Analytics ve Crashlytics için alan şablonu

ÖZEL sorgular

Cloud Spanner

Topluluk Bağlayıcıları

Google Analytics

Google Cloud Storage

Google E-Tablolar

Looker

Search Console

Şablon izinleri

Boş veya varsayılan bir rapor kullan

Rapor yerleştirme

Kimlikleri ve takma adları bulma

Rapor kimliği

Veri kaynağı takma adı

Bağlayıcı türü

İpuçları ve sorun giderme

Hata ayıklama iletişim kutusu

İzinler

Güncelle ve değiştir

Alanları yenile

Geri bildirim ve destek

Değişiklik günlüğü

2023-06-06

2023-05-22

2022-11-21

2022-11-14

2022-06-15

2021-12-16

`ds.connector` ayarlandığında gerekli parametreler