Bağlantı API'si

Giriş

Linking API, kullanıcıları yapılandırmak ve doğrudan bir URL aracılığıyla Data 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üşterilerinizin verilerini görüntüleyip bunlarla etkileşim kurabilmesi 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 verilerine göre 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, Data 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ı 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, Data Studio'nun sağladığı varsayılan rapor şablonunu mu kullanacağınıza yoksa şablon olarak kullanılacak bir Data 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 Linking API 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şim kurmasına olanak tanıyan bir Data Studio raporuna yönlendirecek bir Bağlantı Oluşturma API'si 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ı Data 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 Data Studio raporuna yönlendirilir. Rapor yüklenir ve kullanıcı, verilerini görüntüleyip bunlarla etkileşim kurabilir.
Kullanıcı "Düzenle ve paylaş"ı tıklar. Rapor, Data Studio hesabına kaydedilir.
Kullanıcı artık raporun kendi kopyasına tam erişime ve kontrolüne sahip. İstedikleri zaman görüntüleyebilir, düzenleyebilir ve paylaşabilirler.

Ş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 Data Studio tarafından sağlanan boş veya varsayılan bir rapor kullanılabilir.
Bir Bağlantı 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. Data 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ıdı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 raporlarını ölçme 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 raporlarını ölçme 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 rapordan eklendiğinde/kaldırıldığında geriye dönük uyumluluk için takma ad kullanılabilir.

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. samples - 12/12/21, 10:53 PM). `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. samples - 12/12/21, 10:53 PM). `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ğlama 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ı 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 belirtilmemiş 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ı 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ının 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 şablondaki 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 raporunda 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` seçeneğini `false` olarak ayarlayın. Hesaplanmış alanlar ve şablon veri kaynaklarında tanımlanan 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ü 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 belirtilmeyen 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ı 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 eksiksiz olarak 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 bilinmeyen değerlerin kullanılmasını önler.
Hayır	Güncelle'yi tıklayın. Şablon veri kaynağı yapılandırması, Bağlantı 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ını biliyorsanız ve yalnızca parametrelerin bir alt kümesini geçersiz kılmak istiyorsanız 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

İki veri kaynağıyla (BigQuery veri kaynağı ds0 ve Google Analytics veri kaynağı ds1) 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 belirtilmeyen 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

Veri kaynağında yapılan güncellemelerin tüm raporları birlikte etkilemesi için aynı veri kaynağının birden fazla raporda bulunması bazen yararlı olabilir. Bağlantı oluşturma 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)

Linking API 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ının 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 yerine tableId'yi koruyarak başka bir şey yazmak 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ılabilen 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 bir 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 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

Joker karakter sonekini kullanarak tarih parçalı bir tabloyu 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_*

YYYYMMDD sonekini kullanarak tarih parçalı bir tabloya sorgu uygulamak 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_YYYYMMDD

TABLE alan şablonunu kullanarak Google Analytics için BigQuery Export tablosunu sorgulamak üzere TABLE türü yapılandırma:SESSION

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 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`	Gerekli** 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.
`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ığı ve gizli ile filtrelenmiş hücrelerin bulunduğu 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. Ayarlanırsa 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 önekli 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ı 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ı 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 Bağlantı Oluşturma 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 Data 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 Data 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

Data 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ğunda 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.

Bir veri kaynağı eklendiğinde veya kaldırıldığında geriye dönük uyumluluğu sağlamak için diğer adları düzenleyebilirsiniz.

Veri kaynağı kaynak yönetimi sayfasında veri kaynaklarının listesi.
Takma ad sütunu vurgulanır. — Veri kaynağı takma adını *Veri kaynakları* yönetimi sayfasında 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ğunda 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

Linking API yapılandırmasını Data Studio tarafından yorumlandığı şekliyle 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ına yakın bir yerde 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ı Oluşturma 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, bir rapor şablonu oluşturulurken Data Studio 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. Linking API, tam olarak aynı alanları sağlayan yeni bir veri kaynağı yapılandırması sağlamak için 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ı olan 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 ile ilgili sorunları bildirmek veya geri bildirimde bulunmak için Issue Tracker'ı 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ımı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. Bkz. Boş veya varsayılan rapor kullanma
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 ayar, veri kaynağı yapılandırması yüklenirken veri kaynağı alanlarının yenilenip yenilenmeyeceğini kontrol etmenize olanak tanır.
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 ayarla tutarlı olacak şekilde 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 Surveys, 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