📈

Graph

投稿済みの Pixel をカレンダーヒートマップの形式で表示させたもの、もしくは、その表示内容に関する設定項目のことを指しています。

関連API

に関連するAPIは全部で9個あり、それらは以下の3種類に分類されます。
  1. の作成・削除、プロパティの更新を行うためのAPI
  1. の表示に関するAPI
  1. に関するその他の情報を取得するためのAPI

1. の作成・削除、プロパティの更新を行うためのAPI

2. の表示に関するAPI

3. に関するその他の情報を取得するためのAPI

特徴

には、以下のようなプロパティがあります。

その を一意に識別するための識別子です。その の中で同じ を作ることはできません。Pixela のグラフなどを表示させる際に、URLの一部としても使われます。また、後から変更することはできません。
APIドキュメントなどでこれを指し示す場合、しばしば などのように表現されます。

その の名称が設定されることを想定したプロパティです。ここで設定した内容は GET - /v1/users/<username>/graphs/<graphID>.html などで確認することができます。

その に投稿される数値の単位が設定されることを想定したプロパティです。例えば、 などです。ここで設定した内容は GET - /v1/users/<username>/graphs/<graphID>.html などで確認することができます。

その に投稿される数値が整数であるか、小数であるかを指定します。 もしくは のいずれかのみが指定可能です。また、後から変更することはできません。

その に紐付く Pixel を表示させたときの色を指定することができます。 のいずれかを指定します。それぞれの色を指定したときの実際の色は、以下の画像を参照してください。
カラースキーマごとの配色のサンプルを確認する
shibafu (green)
(green)
momiji (red)
(red)
sora (blue)
(blue)
ichou (yellow)
(yellow)
ajisai (purple)
(purple)
kuro (black)
(black)

以下のいずれかの手段によって が投稿された場合、その時の現在日時が用いられます。
その現在日時を取得する際に考慮するタイムゾーンを、このプロパティで設定できます。
ここで設定した内容は GET - /v1/users/<username>/graphs/<graphID>.html などで確認することができます。

のいずれかの値をこのプロパティに設定することができます。このプロパティの活用方法については 📈サイトのページビューを Pixela で計測し可視化する を参照してください。

ユーザープロフィールページのグラフ一覧表示において、そのグラフを非表示にするかどうかを指定することができるプロパティです。 もしくは を設定します。ただし、 を設定することでグラフを非表示にすることができるのは、Pixelaサポーター限定の機能です。詳しくは 💝Pixela を支援する特典として限定機能を利用可能にする - Pixela サポータープログラム を参照してください。

このプロパティに を設定することで、各 Pixel に記録されている GET - /v1/users/<username>/graphs/<graphID>.html が返す HTML ページ上で閲覧できるようにしたり、グラフのSVG情報に属性として追加させることができます。ただし、 を設定することでこれらの挙動を有効化できるのは、Pixelaサポーター限定の機能です。詳しくは 💝Pixela を支援する特典として限定機能を利用可能にする - Pixela サポータープログラム を参照してください。
詳細な内容や活用方法については 💬Pixel に付加情報を付与する・表示させる も参照してください。

Pixela のグラフを GitHub に埋め込む場合、その画像は自動的に GitHub にキャッシュされます。グラフが更新される度にそのキャッシュをクリアさせたい場合にこのプロパティにURLを設定します。詳しくは GitHub に Pixela のグラフを埋め込む を参照してください。

仕様

  • を削除すると、それに紐付く などの情報もすべて削除されます。

留意事項

  • を明示的に指定しなかった場合、UTCとして扱われます。
  • プロパティを用いてできることは、あくまで一覧表示内容にそのグラフを含めないようにすることだけです。そのグラフのURLを指定しそのグラフを閲覧することを制限することはできません。

関連リンク