TableauPublicAPI2023年版
TableaupublicAPIはここ数年、毎年のように仕様変更が行われ正式なアナウンスは無い。2023年12月現在のAPIの主な使い方を解説する。すべての機能が知りたい方はTableauPublicAPIまとめから辿ってください。
プロフィールの入手
API呼び出し形式
https://public.tableau.com/profile/api/ユーザー名
例: https://public.tableau.com/profile/api/takahiro.yamanashi3736
出力結果
JSON形式で出力される。Viz数、フォロー数といった情報が入手できる。crearedAtが本来日付だが、unix timeになっている。
{
"profileName":"takahiro.yamanashi3736",
"name":"takahiro yamanashi",
"title":"",
"organization":"",
"address":"{"country":"Japan","state":"Aichi"}",
"bio":"JTUG\n中部Tableauユーザ会\n製造業Tableauユーザ会",
"featuredVizRepoUrl":"Tableau_youtube",
"totalNumberOfFollowing":24,
"totalNumberOfFollowers":37,
"visibleWorkbookCount":98,
"createdAt":1593561600000,
"freelance":false,
"hideNewWorkbooks":false,
"websites":[{"id":1021714,"url":"https://twitter.com/mamma_ds","title":"twitter.com"}],
"searchable":true}
ワークブック一覧の入手
指定したユーザー名のワークブック一覧を入手できる。ただし、一度に出力できるのは50まで。次の50はstart=50と指定する必要がある。また、非公開のワークブックは一覧として入手できない。
APIの呼び出し形式
https://public.tableau.com/public/apis/workbooks?profileName=ユーザー名&start=0&count=50&visibility=NON_HIDDEN
例：https://public.tableau.com/public/apis/workbooks?profileName=takahiro.yamanashi3736&start=0&count=50&visibility=NON_HIDDEN
start：ワークブックの開始番号。50毎にしか入手できないので、50以上のワークブックがある場合は、この数値を50→100→150とカウントアップしていく。
count:出力するワークブック数。たぶん50固定にすることが多い。
visibility=NON_HIDDEN：このまま記載しておく。記載が無いとエラーとなる。
出力結果
countを3に設定した時の出力結果。contentsに各ワークブックの情報が記載されている
{"current":0,"next":3,"contents":[
{"workbookRepoUrl":"Tableau_youtube","title":"Tableau_youtubeプレイリスト","defaultViewName":"Tableau","viewCount":1712 ,"numberOfFavorites":17,"authorDisplayName":"takahiro yamanashi","authorProfileName":"takahiro.yamanashi3736","defaultViewRepoUrl":"Tableau_youtube/sheets/Tableau"},
{"workbookRepoUrl":"NULLlookup","title ":"NULLがある場合のlookup参照確認","defaultViewName":"NULLllokup","viewCount":14,"numberOfFavorites":0,"authorDisplayName":"takahiro yamanashi","authorProfileName":"takahiro.yamanashi3736 ","defaultViewRepoUrl":"NULLlookup/sheets/NULLllokup"},
{"workbookRepoUrl":"3VizShow_16932264057790","title":"第3回カジュアルVizつくりまShow","defaultViewName":"Q42","viewCount" :8,"numberOfFavorites":0,"authorDisplayName":"takahiro yamanashi","authorProfileName":"takahiro.yamanashi3736","defaultViewRepoUrl":"3VizShow_16932264057790/sheets/Q42"}
]}
１つのワークブックに注目。ワークブックタイトル、View数、お気に入り数等が出力される。
"workbookRepoUrl":"Tableau_youtube",
"title":"Tableau_youtubeプレイリスト",
"defaultViewName":"Tableau",
"viewCount":1712 ,
"numberOfFavorites":17,
"authorDisplayName":"takahiro yamanashi",
"authorProfileName":"takahiro.yamanashi3736",
"defaultViewRepoUrl":"Tableau_youtube/sheets/Tableau"
ワークブックの詳細を入手
さらにワークブックの情報を引き出すことができます。これはまとめて、取得することはできなく、１つ１つのワークブック毎に入手する必要があります。
APIの呼び出し形式
https://public.tableau.com/profile/api/single_workbook/ワークブック リポジトリ URL?
例：https://public.tableau.com/profile/api/single_workbook/Tableau_youtube?
ワークブックリポジトリURLは先ほどの一覧で入手した
"workbookRepoUrl":"Tableau_youtube",
となる。
最後に?をつけること。
出力結果
詳細として、Publish関連の日付（unix time)、等が入手できる
{"showInProfile":true,
"allowDataAccess":false,
"showByline":true,
"showShareOptions":true,
"showTabs":true,
"showToolbar":true,
"showWatermark":true,
"warnDataAccess":false,
" extractInfo":null,
"id":8114090,
"ownerId":1473014,
"viewCount":1712,
"firstPublishDate":1628951927720,
"lastPublishDate":1670592581473,
"lastUpdateDate":1670592582224,
"size":59280,
"defaultビュー名" :"Tableau系動画一覧",
"defaultViewRepoUrl":"Tableau_youtube/sheets/Tableau",
"description":"Tableau_youtubeプレイリスト",
"luid":"aad02eae-24c3-4ad6-bdae-3f2cd5899362",
"permalink": null,
"revision":"4.5",
"title":"Tableau_youtubeプレイリスト",
"workbookRepoUrl":"Tableau_youtube",
"authorProfileName":"takahiro.yamanashi3736",
"authorDisplayName":"takahiro yamanashi",
"numberOfFavorites" :17,
"属性":[]}