Bağlantı API'si

Giriş

Bağlantı oluşturma API'si, kullanıcıları yapılandırmak ve doğrudan bir URL aracılığıyla Looker Studio raporuna yönlendirmek için güvenilir bir arayüz sağlar. Kullanıcılar bir Bağlantı Oluşturma API'si URL'sini tıkladığında verilerini hızlıca görüntüleyip bunlarla etkileşim kurmak için kolaylaştırılmış bir deneyim yaşar.

Bu belgede, Linking API URL'lerinin gerekli biçimi ve kullanılabilir parametreler açıklanmaktadır.

Kullanım alanı ve avantajları

Linking API, müşterilerinize verilerini görüntüleyip bunlarla etkileşim kurmaları için önceden yapılandırılmış raporlar sağlamak amacıyla 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ğlandığı için kullanıcıların raporu verileri için yapılandırması gerekmez.
- Kullanıcılar raporu tek bir tıklamayla kaydedebilir ve istedikleri zaman tekrar ziyaret edebilir.
Geniş ölçekte rapor oluşturma. Bağlantı oluşturma API'si, raporları kopyalamak veya yeni raporlar oluşturmak için gereken süreyi kısaltır.
Ürün entegrasyonlarını etkinleştirin. Kararlı arayüz, Looker Studio'yu bir ürün iş akışına entegre etmenize olanak tanır.

İşleyiş şekli

Aşağıda, geliştiricilerin ve kullanıcıların Bağlantı Oluşturma API'si ile nasıl etkileşimde bulunduğu açıklanmaktadır.

Linking API geliştirici iş akışı

Geliştirici, şablon raporları ve 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'nun sağladığı varsayılan rapor şablonunu mu kullanacağınıza yoksa şablon olarak kullanılacak bir Looker Studio raporu mu oluşturacağınıza karar verin. Şablon veri kaynaklarının yapılandırılması da buna dahildir.
Belirli kullanım alanınız için bir Bağlantı Oluşturma API'si URL'si biçimlendirin. Varsa rapor şablonunu ve rapor adı, veri kaynağı adı ve veri kaynağı yapılandırmaları gibi diğer parametreleri belirtin.
Kullanıcıları rapora yönlendirmek için Bağlantı Oluşturma API'si URL'sini kullanın.

Linking API kullanıcı deneyimi

Kullanıcı, geliştirici tarafından doğru şekilde yapılandırılmışsa kendisini erişebildiği verileri görüntülemesine ve bu verilerle etkileşime girmesine olanak tanıyan bir Looker Studio raporuna yönlendirecek bir Linking API URL'sini takip eder. Tipik bir kullanıcı deneyimi şu şekilde olabilir:

Kullanıcı, tarayıcıda Bağlantı API'si ile 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 bir Looker Studio raporuna yönlendirilir. Rapor yüklenir ve kullanıcı, verilerini görüntüleyip verileriyle etkileşimde bulunabilir.
Kullanıcı "Düzenle ve paylaş"ı tıklar. Rapor, Looker Studio hesabına kaydedilir.
Kullanıcı artık raporun kendi kopyasına tam erişime ve kontrol yetkisine sahip. Bu kişiler, dosyaları istedikleri zaman görüntüleyebilir, düzenleyebilir ve paylaşabilir.

Şartlar

Bağlantı oluşturma API'si URL'sinin beklendiği gibi çalışması için aşağıdakiler gereklidir:

Şablon olarak kullanılacak bir rapor. Bu bilgiler sağlanmazsa Looker Studio tarafından sağlanan boş veya varsayılan rapor kullanılabilir.
Bir Bağlantı Oluşturma API'si URL'sinin kullanıcıları, şablon raporuna en azından görüntüleme erişimine sahip olmalıdır. Raporlarda 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ına görüntüleme erişimi de gerekebilir. Ayrıntılar için Şablon izinleri başlıklı makaleyi inceleyin.
Her veri kaynağının Bağlayıcı türü, Bağlantı API'si üzerinden yapılandırmayı desteklemelidir. Desteklenen bağlayıcıların listesi için Bağlayıcı referansı'na bakın.
Bağlantı oluşturma API'si URL'sinin kullanıcıları, Bağlantı oluşturma API'si 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

Bir Bağlantı Oluşturma API'si URL'si aşağıdaki biçimde olmalıdır:

https://lookerstudio.google.com/reporting/create?parameters

URL'nin genellikle bir kullanıcının bağlantıyı tıklaması veya URL'ye yönlendirilmesiyle web tarayıcısı bağlamında kullanılması beklenir. Ayrıca rapor yerleştirmek için de kullanılabilir.

Örnek URL

Aşağıda, örnek bir Linking API URL'si verilmiştir. Rapor adı ayarlanmış ve tek bir BigQuery veri kaynağı yapılandırılmış olmalıdı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

Bazı URL parametreleri zorunlu, bazıları ise isteğe bağlıdır. Aşağıda, bir Bağlantı Oluşturma API'si URL'sini tanımlamak için kullanılan parametrelerin listesi verilmiştir:

Kontrol parametreleri

Kontrol parametreleri, raporun Bağlantı Oluşturma API'si URL'si üzerinden görüntülendiğindeki durumunu belirler.

Parametre adı	Açıklama
`c.reportId`	İsteğe bağlı. Şablon rapor kimliği. Looker Studio açılır ve belirtilen raporu yapılandırır. Kimliği bulmayla ilgili ayrıntılar için Bildirim 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 rapor kullanma başlıklı makaleyi inceleyin.
`c.pageId`	İsteğe bağlı. Raporda yüklenecek ilk sayfanın kimliği. Belirtilmezse varsayılan olarak raporun ilk sayfası kullanılır.
`c.mode`	İsteğe bağlı. İlk rapor modu. Şunlardan biri: `view` veya `edit`. Belirtilmezse varsayılan olarak `view` olur.
`c.explain`	İsteğe bağlı. Bilgi/hata ayıklama iletişim kutusunun görünürlüğü. İletişim kutusu düğmesini göstermek için `true` olarak ayarlayın. Belirtilmezse varsayılan olarak `false` olur. Daha fazla bilgi için Yapılandırma sorunlarını giderme başlıklı makaleyi inceleyin.

Ö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. Belirtilmezse varsayılan olarak şablon rapor adı kullanılır.
`r.measurementId`	İsteğe bağlı. Google Analytics ölçüm kimliklerini, kullanımı ölçmek olarak ayarlar. Birden çok kimliği ayırmak için virgül kullanın. `r.measurementId` ve `r.keepMeasurementId` belirtilmemişse Google Analytics ölçüm kimlikleri raporu 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ı. Şablon raporu kullanmak için `true` olarak ayarlayın. Google Analytics ölçüm kimlikleri. Belirtilmezse varsayılan olarak `false` olur. `r.measurementId` ve `r.keepMeasurementId` belirtilmemişse Google Analytics ölçüm kimlikleri raporu 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. Belirtilmezse varsayılan olarak şablon rapor adı kullanılır.

r.measurementId

İsteğe bağlı. Google Analytics ölçüm kimliklerini, kullanımı ölçmek olarak ayarlar. Birden çok kimliği ayırmak için virgül kullanın.

r.measurementId ve r.keepMeasurementId belirtilmemişse Google Analytics ölçüm kimlikleri raporu 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ı. Şablon raporu kullanmak için true olarak ayarlayın. Google Analytics ölçüm kimlikleri. Belirtilmezse varsayılan olarak false olur.

Ö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, bir veri kaynağı yapılandırması ve şablon rapordaki veri kaynakları için erişilecek verileri tanımlamanıza olanak tanır.

Mevcut bir rapordaki veri kaynağına referans vermek için alias kullanılır. Bir veri kaynağı şablon raporuna eklenir veya rapordan kaldırılırsa takma ad kullanmak geriye dönük uyumluluk sağlar.

Veri kaynağı bulma hakkında ayrıntılı bilgi için alias 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` belirtilmemişse veri kaynağı adı, bağlayıcı türünü ve oluşturulma zamanını içeren bir adlandırma kuralına göre belirlenir (ör. örnekler - 12/12/21, 22:53). `ds.datasourceName` ve `ds.keepDatasourceName` ayarlanmışsa veri kaynağı adını ayarlamada `ds.datasourceName` öncelikli olur.
`ds.alias.keepDatasourceName`	İsteğe bağlı. Şablon veri kaynağı adını kullanmak için `true` olarak ayarlayın. Belirtilmezse varsayılan olarak `false` olur. `ds.datasourceName` ve `ds.keepDatasourceName` belirtilmemişse veri kaynağı adı, bağlayıcı türünü ve oluşturulma zamanını içeren bir adlandırma kuralına göre belirlenir (ör. örnekler - 12/12/21, 22:53). `ds.datasourceName` ve `ds.keepDatasourceName` ayarlanmışsa veri kaynağı adını ayarlamada `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ı başlıklı makaleyi inceleyin. Ayarlanırsa bağlayıcı türü için gerekli tüm bağlayıcı parametreleri, Bağlantı Oluşturma API'si URL'sinde belirtilmelidir ve şablon veri kaynağı yapılandırması tamamen değiştirilir. Belirtilmemişse Bağlantı API'si URL'sinde bağlayıcı türü için sıfır veya daha fazla bağlayıcı parametresi belirtilebilir. Şablon veri kaynağı yapılandırması, Bağlantı Oluşturma API'si URL'sinde sağlanmayan parametreleri belirtmek için kullanılır. Şablon veri kaynağının bağlayıcı türünü belirleme hakkında ayrıntılı bilgi için Bağlayıcı türü başlıklı makaleyi inceleyin. `ds.connector` parametresinin, şablon veri kaynağı yapılandırmasının tamamen değiştirilmesini veya belirtilmeyen parametreleri güncellemek için kullanılmasını nasıl etkilediği hakkında daha fazla bilgi edinmek için Değiştirme ve güncelleme başlıklı makaleyi inceleyin.
`ds.alias.refreshFields`	İsteğe bağlı. Bağlantı oluşturma API'si aracılığıyla belirtilen veri kaynağı yapılandırmasını kullanarak veri kaynağı alanlarını yenilemek ve rapor bileşenlerini yeni alan seçimleriyle güncellemek için `true` olarak ayarlayın. `true` genellikle bağlayıcı türü değiştirilirken veya yapılandırma değişikliğinin farklı alanlar sağladığı bağlayıcı türleri için (ör. BigQuery veri kaynaklarına ait alanlar genellikle farklı tablo yapılandırmalarıyla değişir) belirtilir. Veri kaynağı alanlarını şablon raporunda olduğu gibi 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 alan değişikliklerini korumak istediğinizde belirtilir. Belirtilmemişse varsayılan değerler bağlayıcı türüne göre değişir. Varsayılan davranışı geçersiz kılmak isterseniz bağlayıcıya özgü varsayılanlar için Bağlayıcı referansı'nı inceleyin. `refreshFields` özelliğini kullanırken dikkat edilmesi gereken noktalar: `refreshFields`, `false` olarak ayarlanmışsa ve Bağlantı Oluşturma API'si aracılığıyla belirtilen veri kaynağı yapılandırması, şablon raporda kullanılanlardan farklı alanlar veriyorsa kullanıcı, etkilenen bileşenlerle ilgili bir yapılandırma hatası görür. Şablon veri kaynağındaki alanlarda yapılan değişiklikler (ör. ad, tür, toplama vb.), `refreshFields` ayarı `true` olarak belirlendiğinde yeni veri kaynaklarına aktarılmaz. Şablon veri kaynağındaki alan yapılandırmalarını korumak için `refreshFields` değerini `false` olarak ayarlayın. Hesaplanmış alanlar ve Parametreler şablon veri kaynaklarında tanımlandığında her zaman yeni oluşturulan veri kaynaklarına kopyalanır ve `refreshFields` değerinden etkilenmez.
`ds.alias.connectorParameters`	Zorunludur. Bağlayıcı türü için veri kaynağı yapılandırması. Veri kaynağı oluşturmak için kullanılan bağlayıcının nasıl belirleneceği hakkında ayrıntılı bilgi için Bağlayıcı türü başlıklı makaleyi inceleyin. Her bağlayıcı türü için kullanılabilen veri kaynağı parametreleri hakkında ayrıntılı bilgi edinmek için Bağlayıcı referansı başlıklı makaleyi inceleyin.

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

Veri kaynağı parametreleri ayarlanırken, Bağlantı API'si URL'sinde ds.connector parametresinin bulunması veya bulunmaması, sırasıyla şablon veri kaynağı yapılandırmasını 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 açıklanmaktadır:

`ds.connector` ayarlanmış mı?	Beklenen yapılandırma ve davranış	Tipik kullanım
Evet	Değiştir'e dokunun. Şablon veri kaynağı yapılandırması, Bağlantı Oluşturma API'si URL'sinde belirtilen veri kaynağı parametreleri kullanılarak tamamen değiştirilir. Konnektör türü için gerekli tüm parametreleri belirtmeniz gerekir. `ds.connector` ayarlandığında gerekli parametreler başlıklı makaleyi inceleyin.	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ınız ancak Bağlantı Oluşturma API'si aracılığıyla bir E-Tablolar veri kaynağı yapılandırmak istiyorsunuz. Bu işlem 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ı garanti etmek istediğinizde Yapılandırmanın değiştirilmesi, şablon veri kaynağından kullanılabilecek bilinmeyen değerleri önler.
Hayır	Güncelle'yi tıklayın. Şablon veri kaynağı yapılandırması, Bağlantı Oluşturma API'si URL'sinde sağlanmayan parametreleri belirtmek için kullanılır. Aksi belirtilmediği sürece, bağlayıcı türü için tüm bağlayıcı parametreleri isteğe bağlıdır. Bu, Bağlantı Oluşturma API URL'sini basitleştirir ve şablon veri kaynağı yapılandırmasına aşina olduğunuzda ve yalnızca bir parametre alt kümesini geçersiz kılmak istediğinizde genellikle önerilir.	Yalnızca şablon veri kaynağından farklı olan parametre değerlerini sağlamak istediğinizde ve belirtilmeyen bağlayıcı parametreleri için şablon veri kaynağına güvenmek istediğinizde. Örneğin, yalnızca bir BigQuery veri kaynağı yapılandırmasının faturalandırma proje 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 belirtilmişse veri kaynağı için Zorunlu olarak belirlenen tüm bağlayıcı parametreleri belirtilmelidir. Veri kaynağının ds.connector parametresi belirtilmemişse aksi belirtilmediği sürece zorunlu olarak belirlenenler de dahil olmak üzere tüm bağlayıcı parametreleri isteğe bağlı olarak değerlendirilebilir.

Örnekler

Tek bir BigQuery veri kaynağıyla (ds0) bir raporu 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

Raporun tek bir veri kaynağı olduğunda veri kaynağı takma adı atlanabilir. Yukarıdaki URL şu ş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

Tek bir BigQuery veri kaynağı (ds0) içeren bir raporu yapılandırır ve yalnızca veri kaynağının faturalandırma proje kimliğini günceller:

https://lookerstudio.google.com/reporting/create?
  c.reportId=12345
  &r.reportName=MyNewReport
  &ds.ds0.billingProjectId=my-billing-project

BigQuery veri kaynağı (ds0) ve Google Analytics veri kaynağı (ds1) olmak üzere iki veri kaynağı içeren bir rapor yapılandırır. BigQuery veri kaynağı yapılandırması tamamen değiştirilirken Google Analytics yapılandırması tek bir parametreyi günceller ve belirtilmemiş 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 durumda, veri kaynağında yapılan güncellemeler tüm raporları birlikte etkiler. Bağlantı API'si ile rapor oluştururken aşağıdaki koşulların tümünün karşılandığından emin olarak şablon raporunuzdaki bir veri kaynağını yeniden ekleyebilirsiniz:

Veri kaynağı yeniden kullanılabilir (yerleştirilmiş ve yeniden kullanılabilir veri kaynakları başlıklı makaleyi inceleyin)
URL, veri kaynağına takma adla referans vermiyor
URL'de joker karakterli bir takma ad kullanılmıyor (bkz. Veri kaynağı takma adı joker karakteri)

Bağlantı oluşturma API'si ile yeni bir veri kaynağı oluşturulduğunda, URL'yi tıklayan kullanıcının kimlik bilgileri kullanılır. Bu nedenle, kullanıcının temel verilere erişimi olmalıdır. Aksi takdirde bağlantı çalışmaz. Veri kaynağını yeni oluşturulan rapora yeniden ekleyerek kimlik bilgilerini koruyabilir, böylece kullanıcılar yeni raporlarındaki verilere erişmeye devam edebilir.

Veri kaynağı takma adı joker karakteri

Bir Linking API parametresini birden fazla veri kaynağına uygulamak için veri kaynağı takma adı yerine joker karakter takma adı ds.* kullanılabilir.

Bu, URL'nizdeki tekrarlayan parametreleri kaldırmak için yararlı olabilir. Örneğin, üç BigQuery veri kaynağının bağlı olduğu bir şablonunuz varsa ve her birinde projectId ile datasetId öğelerini değiştirmek ancak tableId öğesini korumak istiyorsanız bunu ş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

Alternatif olarak, ds.* joker karakteriyle şu eşdeğer URL'yi kullanabilirsiniz:

  https://lookerstudio.google.com/reporting/create?
  c.reportId=7890
  &ds.*.projectId=client-project
  &ds.*.datasetId=client-dataset

Bağlantı oluşturma API'sine sağlanan ve ds.* joker karakterini kullanmayan parametreler, bu karakteri kullananlara 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, parametre önceliği sırası şöyledir:

Belirli bir takma adla (ds.ds1.datasetId) verilen 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 (bkz. Değiştirme ve güncelleme)
Parametre isteğe bağlıysa varsayılan değeri.

Bağlayıcı referansı

Bağlantı oluşturma API'si aşağıdaki bağlayıcıları ve yapılandırmaları destekler. Her bağlayıcı için kullanılabilir veri kaynağı parametrelerinin listesi sağlanır.

BigQuery

BigQuery bağlayıcısı iki tür sorguyu destekler: TABLE sorgusu (sorgulanacak tablonun tablo kimliğini sağladığınız sorgu) ve CUSTOM_QUERY sorgusu (tabloyu sorgulamak için SQL ifadesi sağladığınız sorgu).

TABLO sorguları

type, TABLE olarak ayarlandığında ve sorgulanacak tablonun kimliğini sağladığınızda aşağıdaki parametreler geçerlidir.

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. Bkz. Değiştirme ve güncelleme.
`ds.alias.type`	Zorunlu** Sorgu 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. Tarihe göre parçalanmış tablolar: Tarihe göre parçalanmış tablolar sorgulanırken * (joker karakter) veya `YYYYMMDD` soneki desteklenir. Bir tablo Google Analytics, Firebase Analytics veya Firebase Crashlytics olarak tanımlanırsa belirtilmediği sürece varsayılan alanlar ş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 için geçerlidir (ör. zamana dayalı bölümlendirme sütunu veya `_PARTITIONTIME` sözde sütunu kullanma) ve tam sayı aralığına göre bölümlendirilmiş tablolarda çalışmaz. Belirtilmezse varsayılan olarak `false` olur. Daha fazla bilgi edinmek için Bölümlendirilmiş tablolara giriş başlıklı makaleyi inceleyin.
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields sayfasına 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. Belirtilmemişse varsayılan bir şablon seçilir.

Ad	Açıklama
`ds.alias.gaTemplateLevel`	İsteğe bağlı. Kullanılacak Google Analytics alanları şablonu. Yalnızca bir Google Analytics için BigQuery Export tablosu sorgulanırken geçerlidir. `ALL`, `SESSION`, `HITS`. Google Analytics tablolarında belirtilmezse varsayılan olarak `ALL` olur.
`ds.alias.firebaseTemplateLevel`	İsteğe bağlı. Kullanılacak Firebase Analytics alanları şablonu. Yalnızca Firebase Analytics tablosu için BigQuery Export sorgulanırken geçerlidir. Yalnızca `EVENTS` olarak ayarlanabilir. Firebase Analytics tablolarında, belirtilmezse varsayılan olarak `EVENTS` olur.
`ds.alias.crashlyticsTemplateLevel`	Kullanılacak Firebase Crashlytics alanları şablonu. Yalnızca `DEFAULT` olarak ayarlanabilir. Yalnızca Firebase Crashlytics tablosu için BigQuery Export sorgulanırken geçerlidir. Firebase Crashlytics tablolarında, belirtilmezse varsayılan olarak `DEFAULT` olur.

Ö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çerlidir.

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. Bkz. Değiştirme ve güncelleme.
`ds.alias.type`	Zorunlu** Sorgu 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` ayarlanmamışsa 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 değiştirme dizesi çiftlerini ayırmak için virgül kullanın. Örneğin, `stringPattern1,replacementString1, stringPattern2,replacementString2`.
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields sayfasına bakın.

Örnekler

Sorgunun tablo kimliğiyle tanımlandığı 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=bigquery-public-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=shakespeare
  &ds.ds0.billingProjectId=myProject

Tarih parçalı bir tabloyu joker karakter sonekiyle sorgulamak için TABLE türünde bir yapılandırma:

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_*

TABLE sonekini kullanarak tarihle parçalanmış bir tabloya sorgu uygulamak için YYYYMMDD 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=price-data
  &ds.ds0.datasetId=samples
  &ds.ds0.tableId=stock_YYYYMMDD

TABLE alan şablonunu kullanarak Google Analytics için BigQuery Export tablosunu sorgulamak üzere SESSION 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ırma:

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

Sorgunun bir SQL ifadesiyle tanımlandığı CUSTOM_QUERY türü yapılandırma:

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ında ş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 bir 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ı. `cloudSpanner` olarak ayarlayın. Cloud Spanner bağlayıcısı. Ayarlanırsa veri kaynağını sağlanan Cloud Spanner yapılandırmasıyla değiştirir. Bkz. Değiştirme ve güncelleme.
`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ı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields başlıklı makaleyi inceleyin.

Ö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. Ayarlanmışsa veri kaynağını sağlanan Topluluk Bağlayıcısı yapılandırmasıyla değiştirir. Bkz. Değiştirme ve güncelleme.
`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ında tanımlandığı şekilde, bağlayıcıya özel ek parametreler. bağlayıcı yapılandırması.
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields sayfasına bakın.

Örnek

state ve city yapılandırma parametreleriyle bir 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. Bkz. Değiştirme ve güncelleme.
`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ı. Belirtilmezse varsayılan olarak `false` olur. Ayrıntılar için refreshFields sayfasına 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` olarak ayarlayın. Google Cloud Storage bağlayıcısı. Ayarlanırsa veri kaynağını, sağlanan Google Cloud Storage yapılandırmasıyla değiştirir. Bkz. Değiştirme ve güncelleme.
`ds.alias.pathType`	Zorunlu** Yol türü. Tek bir dosyayı seçmek için `FILE`, belirli bir yoldaki tüm dosyaları seçmek için `FOLDER` simgesini kullanın.
`ds.alias.path`	Zorunlu** `pathType` `FILE` ise dosya yolu (ör. MyBucket/MyData/MyFile.csv), `pathType` `FOLDER` ise klasör yolu (ör. *MyBucket/MyData).
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields başlıklı makaleyi inceleyin.

Ö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 `googleSheets` olarak ayarlayın. Ayarlanırsa veri kaynağının yerini sağlanan Google E-Tablolar yapılandırması alır. Bkz. Değiştirme ve güncelleme.
`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. Belirtilmezse varsayılan olarak `true` olur. 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. Belirtilmezse varsayılan olarak `true` olur.
`ds.alias.includeFilteredCell`	İsteğe bağlı. Filtrelenmiş hücreleri dahil etmek için `true` olarak ayarlayın. Belirtilmezse varsayılan olarak `true` olur.
`ds.alias.range`	İsteğe bağlı. Aralık (ör. A1:B52).
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `true` olur. Ayrıntılar için refreshFields sayfasına 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

Bir aralığı (A1:D20) içeren 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. Bkz. Değiştirme ve güncelleme.
`ds.alias.instanceUrl`	Zorunlu** Looker örneği URL'si.
`ds.alias.model`	Zorunlu** Looker modeli.
`ds.alias.explore`	Zorunlu** Looker Keşfi.
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `false` olur. Ayrıntılar için refreshFields sayfasına bakın.

Örnek

Looker Keşfedin'e 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. Ayarlanmışsa veri kaynağını sağlanan Search Console yapılandırmasıyla değiştirir. Bkz. Değiştirme ve güncelleme.
`ds.alias.siteUrl`	Zorunlu** Site URL'si. Alan mülkü için `sc-domain\:` ile başlayın.
`ds.alias.tableType`	Zorunlu** Tablo türünü ayarlar. `SITE_IMPRESSION` veya `URL_IMPRESSION` olabilir.
`ds.alias.searchType`	Zorunlu** Arama türünü ayarlar. `WEB`, `IMAGE`, `VIDEO` veya `NEWS` olabilir.
`ds.alias.refreshFields`	İsteğe bağlı. Belirtilmezse varsayılan olarak `false` olur. Ayrıntılar için refreshFields sayfasına bakın.

Örnek

URL önek 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 deneyimi sunmak için şablon raporunuz ve ilişkili veri kaynaklarınız için rapor erişim izinlerini doğru şekilde ayarlamanız önemlidir. Gerekli izinler, rapor şablonunun yerleştirilmiş ve yeniden kullanılabilir veri kaynakları kullanması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 ayarlanmamasına bağlıdır.

Aşağıdaki tabloda, şablon veri kaynakları ve Linking API yapılandırmasına göre en iyi kullanıcı deneyimi için önerilen veri kaynağı erişimi sağlanmaktadır:

Veri kaynağı türü	Veri kaynağı için API yapılandırmasını bağlama	Veri kaynağı izinleriyle ilgili öneri	Notlar
Yerleşik	Değiştir	Geçerli değil: Görüntüleme erişimi rapordan devralınır.	Kullanıcının şablon rapora görüntüleme erişimi varsa yerleştirilmiş tüm veri kaynaklarına otomatik olarak görüntüleme erişimi olur.
Yerleşik	Güncelle	Geçerli değil: Görüntüleme erişimi rapordan devralınır.	Kullanıcının şablon rapora görüntüleme erişimi varsa yerleştirilmiş tüm veri kaynaklarına otomatik olarak görüntüleme erişimi olur.
Yeniden kullanılabilir	Değiştir	Kullanıcıların görüntüleme erişimine ihtiyacı yoktur.	Veri kaynağı yapılandırması, Bağlantı Oluşturma API'si aracılığıyla tamamen değiştirildiğinden görüntüleme erişimi gerekmez.
Yeniden kullanılabilir	Güncelle	Kullanıcıların görüntüleme erişimi olmalıdır.	Linking API'nin şablon veri kaynağındaki yapılandırmayı okuyup kullanabilmesi için veri kaynağına görüntüleme erişimi gerekir. Kullanıcıların görüntüleme erişimi yoksa rapor yüklenirken hata mesajı alırlar.

Boş veya varsayılan bir rapor kullanma

Boş bir raporu veya varsayılan raporu 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 raporun tek bir yerleştirilmiş veri kaynağı olduğundan, varsayılan rapor için veri kaynağı parametreleri belirtirken veri kaynağı takma adı kullanmanız gerekmez.

Varsayılan rapor Looker Studio tarafından sağlanır.

Varsayılan raporun tek bir yerleştirilmiş veri kaynağı olduğundan, varsayılan rapor için veri kaynağı parametreleri belirtirken veri kaynağı takma adı kullanmanız gerekmez.

Aşağıdaki örneklerde, boş veya varsayılan bir raporu kullanan çeşitli Linking API URL'leri gösterilmektedir.

Boş bir raporla rapor oluşturma iş akışını başlatın:

https://lookerstudio.google.com/reporting/create

Boş bir raporla rapor oluşturma iş akışını başlatır 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

Linking API ile oluşturulan bir raporu yerleştirmek için URL parametrelerini ayarlayın ve /embed/ yolunu ekleyin. Bir Bağlantı Oluşturma 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 inceleyin. reporting/ ile /page arasındaki bölü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 vurgulanır. — Rapor URL'sinde rapor kimliğini bulun.

Veri kaynağı takma adı

Bir raporda birden fazla veri kaynağı olabilir. Veri kaynağı, takma adıyla referans verilmelidir.

Veri kaynağı takma adı bulmak için:

Raporu düzenleyin.
Araç çubuğundan Kaynak > Eklenmiş veri kaynaklarını yönetin'i seçin.
Her veri kaynağı için takma ad bilgilerini bulmak üzere Takma ad sütununu inceleyin.

Veri kaynağı eklenirken veya kaldırılırken geriye dönük uyumluluğu sağlamak için takma adları düzenleyebilirsiniz.

Veri kaynağı kaynak yönetimi sayfasında veri kaynaklarının listesi.
Takma ad sütunu vurgulanır. — *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 fazla veri kaynağı olabilir. Veri kaynağı oluşturmak için kullanılan bağlayıcı türünü bulmak üzere:

Raporu düzenleyin.
Araç çubuğundan Kaynak > Eklenmiş veri kaynaklarını yönetin'i seçin.
Veri kaynağı oluşturmak için kullanılan bağlayıcıyı belirlemek üzere Bağlayıcı Türü sütununu inceleyin.

Veri kaynağı kaynak yönetimi sayfasında veri kaynaklarının listesi.
Bağlayıcı Türü sütunu vurgulanır. — *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 sık karşılaşılan yanlış yapılandırmaları belirlemek için aşağıdaki ayrıntıları inceleyin.

Hata ayıklama iletişim kutusu

Looker Studio tarafından yorumlanan Bağlantı Oluşturma API yapılandırmasını incelemek için hata ayıklama iletişim kutusunu kullanın. API ile ilgili sorunların giderilmesine yardımcı olabilir.

Bağlantı oluşturma API'si URL'si ayrıştırılırken bir hatayla karşılaşıldığında, hatayla ilgili ayrıntıların yer aldığı bir iletişim kutusu otomatik olarak gösterilir.
Bir hata oluştuğunda ve otomatik olarak bir iletişim kutusu gösterilmediğinde raporun sağ üst kısmındaki bilgi düğmesini bulun. Ek hata ayıklama bilgileri için tıklayın.
Bilgi düğmesi yoksa herhangi bir Bağlantı Oluşturma API'si URL'sinin sonuna &c.explain=true parametresini ekleyerek düğmeyi etkinleştirebilirsiniz.

İzinler

Veri kaynağı türleri ve Bağlantı Oluşturma API'si yapılandırması için doğru şablon izinlerinin ayarlandığından emin olun. Ayrıntılar için Şablon izinleri başlıklı makaleyi inceleyin.

Güncelleme ve değiştirme

Veri kaynağı yapılandırmasını bir veri kaynağı şablonundan güncelliyorsanız şablon veri kaynağı yapılandırmasını ve Linking API yapılandırmasını inceleyerek uyumlu olduklarından emin olun. 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 işlemleri sırasında, davranışı tanımlanmamış geçersiz bir yapılandırma ayarlanabilir. Ayrıntılar için Değiştirme ve güncelleme başlıklı makaleyi inceleyin.

Alanları yenileme

Bir şablon veri kaynağı için alan adlarını, türlerini veya toplamalarını yapılandırdıysanız bu değişiklikler yalnızca ds.refreshFields parametresi false olarak ayarlanırsa Linking API ile yapılandırılmış bir veri kaynağına aktarılır.

Bağlantı oluşturma API'si URL'nizin ds.refreshFields veri kaynağı parametresini inceleyin. Atlanırsa her bağlayıcı türü için parametrenin varsayılan değerinin kullanım alanınız için doğru olduğunu onaylayın.

Genel olarak, şablondaki veri kaynağında alanları yapılandırdıysanız ve Bağlantı API'si aracılığıyla yapılan yeni veri kaynağı yapılandırmalarının her zaman tam olarak aynı alanları sağlayacağından eminseniz refreshFields değerini false olarak ayarlamanız önerilir.

Örneğin, Looker Studio bir rapor şablonu oluşturulurken belirli bir veri kaynağı alanını Sayı türü olarak tanımlarsa ve siz bunu Yıl türü olarak değiştirirseniz bu alan yapılandırma değişikliği artık şablon veri kaynağının bir parçası olur. Rapor şablonundaki düzeltilmiş alanı kullanan tüm grafikler Yıl bekler. Grafik zamana dayalıysa aksi takdirde oluşturulmayabilir. Tam olarak aynı alanları sağlayan yeni bir veri kaynağı yapılandırması sağlamak için Bağlantı API'si kullanılıyorsa refreshFields parametresinin değerine bağlı olarak iki sonuç ortaya çıkar:

true olarak ayarlanırsa şablondaki veri kaynağının alan yapılandırması aktarılmaz ve aynı alan yapılandırmasına (ör. Yıl türünde bir alan beklenir) bağlıysa grafikler yüklenemeyebilir.
false olarak ayarlanırsa şablondaki veri kaynağının alan yapılandırması yeni veri kaynağına aktarılır ve rapor grafikleri aynı yapılandırmaya sahip aynı alanları alarak başarıyla yüklenir.

Geri bildirim ve destek

Linking API sorunlarını bildirmek veya geri bildirimde bulunmak için Sorun İzleyici'yi kullanın. Yardım alma ve soru sorma ile ilgili genel kaynaklar için Destek bölümüne bakın.

Değişiklik günlüğü

2023-06-06

r.measurementId ve r.keepMeasurementId rapor parametreleri, Google Analytics ölçüm kimlikleri rapor ayarını yapılandırmak için eklendi.
Şablon veri kaynağı adının yeniden kullanılmasını kontrol etmek için ds.keepDatasourceName eklendi.
Raporu yerleştir 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 değiştirme dizeleri belirtmenize olanak tanır.

2023-05-22

Looker bağlayıcısı için destek eklendi.
Topluluk Konnektörleri için destek eklendi.

2022-11-21

Boş rapor kullanma özelliği eklendi. Boş veya varsayılan rapor kullanma başlıklı makaleye bakın.
refreshFields bölümü eklendi. İpuçları ve sorun giderme

2022-11-14

Surveys bağlayıcı referansı, Google Surveys'in kullanımdan kaldırılması nedeniyle kaldırıldı.

2022-06-15

Betadan çıktı
- Integration API'nin adı Linking API olarak değiştirildi.
- Linking API'nin beta sürümü sona erdi.
Belirli bir rapor sayfasına bağlantı oluşturmaya olanak tanıyan pageId kontrol parametresi eklendi.
Rapor durumunu yükleme sırasında Görüntüleme veya Düzenleme moduna ayarlamak için mode kontrol parametresi eklendi.
Veri kaynağı yapılandırmaları artık tamamen veya kısmen değiştirilebiliyor. Bu davranış, ds.connector parametresinin ayarlanıp ayarlanmadığına göre belirlenir. Ayrıntılar için Değiştirme ve güncelleme başlıklı makaleyi inceleyin.
c.reportId parametresi kullanılarak bir rapor şablonu sağlanmazsa artık varsayılan şablon kullanılır.
ds.refreshFields veri kaynağı parametresi eklendi. Bu seçenek, veri kaynağı yapılandırması yüklenirken veri kaynağı alanlarının yenilenip yenilenmeyeceğini kontrol etmenizi sağlar.
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 geri döner.
- 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.
- Tarihe göre bölümlendirilmiş tabloların joker karakter veya YYYYMMDD tablo son eki kullanılarak sorgulanması için destek eklendi.
- Google Analytics, Firebase Analytics veya Crashlytics tablolarına sorgu gönderme ve alan şablonu seçme desteği eklendi.
Google E-Tablolar
- hasHeader, web kullanıcı arayüzündeki varsayılan değerle tutarlı olarak varsayılan olarak true değerine ayarlanır.
- includeHiddenAndFilteredCell, includeHiddenCells ve
- includeFilteredCells. Her ikisi de artık web kullanıcı arayüzü varsayılanıyla tutarlı olacak şekilde true olarak ayarlanıyor.
Search Console bağlayıcısı
- propertyType parametresinin adı searchType olarak değiştirildi.
Anketler bağlayıcısı
- surveyId artık tek bir anket kimliğini veya virgülle ayrılmış anket kimlikleri 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 veri kaynağı adı ayarlanabilir.
- Şu bağlayıcı türleri desteklenir: BigQuery, Cloud Spanner, Google Analytics, Google Cloud Storage, Google E-Tablolar, Google Anketler, Search Console.

Bağlantı API'si Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

Giriş

Kullanım alanı ve avantajları

İşleyiş şekli

Linking API geliştirici iş akışı

Linking API kullanıcı deneyimi

Şartlar

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

TABLO 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 kullanma

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üncelleme ve değiştirme

Alanları yenileme

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

Bağlantı API'si

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