メインコンテンツへスキップ
公開されたノートを探し、本文を読み、チャートの数値を取得します。

探す

検索語を、コマンドのすぐあとに書きます。結果は、人が読みやすい表で出ます。--json を付けると、JSON になります。
--limit は、返す件数の上限です。50 までです。 自分のコンテンツを一覧したいときは、検索語を空にして、--scope mine を付けます。
結果の has_more が true のときは、まだ続きがあります。next_offset の値を --offset に渡すと、次のページを取得できます。

id を見つける

検索結果の各項目に、id と URL が出ます。id は、fetch など、次のコマンドに渡す値です。URL は、人にコンテンツを伝えるときに使います。

本文を読む

<id> は、検索結果に表示された id に置き換えます。実行結果は、ダッシュボード Sales Orders Dashboard(id は pQ9rS0tU1v)で実行したものです。Total Sales(440,826,130)は、Number チャート Total Sales の値です。長い出力は省略しています。 実行結果
ノート、ダッシュボード、スライドは、本文と、埋め込まれた各チャートの先頭の行、各アナリティクスの説明が返ります。見出しの一覧は、返せるだけの長さがあるノートでは、metadata.toc にあります。

長いノートを読む

長いノートは、全部を読まずに、必要なところだけを読めます。見出しを 1 つ指定するときは、metadata.toc にある見出しの id を --section に渡します。
s2 は、metadata.toc にある見出しの id に置き換えます。metadata.toc が返らないときは、--include-toc を付けるか、先に --query で検索し、結果に表示された見出しの id を使います。 話題から探すときは、--query に言葉を渡します。スペースで区切った言葉のどれかを含む段落を、見出しの経路つきで返します。
長くて途中で切れたときは、metadata.range.next_cursor の値を --cursor に渡して、続きを読みます。

中のチャートの数値を取得する

ノートやダッシュボードに含まれるチャートの名前は、fetch の結果の metadata.charts にあります。その名前を --chart に渡すと、チャートの数値を取得できます。
<id> はノートなどの id、<chart> はチャートの名前に置き換えます。実行結果は、ダッシュボード(id は pQ9rS0tU1v)のチャート qR0sT1uV(Monthly Sales Trend)のものです。長い出力は省略しています。 実行結果
結果には、数値の意味(集計方法、フィルタ、パラメーターの値、データの時点)が含まれます。数値を人に伝えるときは、これもあわせて伝えてください。 チャートの形を見たいときは、画像を取得します。画像は公開したときのもので、データより古いことがあります。正確な数値は、画像ではなく chart get-data で読みます。
アナリティクスの結果は、fetch の結果の metadata.blocks にある名前を --analytics に渡して取得します。