📈
Graph
投稿済みの Pixel をカレンダーヒートマップの形式で表示させたもの、もしくは、その表示内容に関する設定項目のことを指しています。
関連API
に関連するAPIは全部で9個あり、それらは以下の3種類に分類されます。
- の作成・削除、プロパティの更新を行うためのAPI
- の表示に関するAPI
- に関するその他の情報を取得するためのAPI
1. の作成・削除、プロパティの更新を行うためのAPI
- POST - /v1/users/<username>/graphs
- を新規登録するためのAPIです。
- PUT - /v1/users/<username>/graphs/<graphID>
- 登録済みの を更新するためのAPIです。
- DELETE - /v1/users/<username>/graphs/<graphID>
- 登録済みの を削除するためのAPIです。
2. の表示に関するAPI
- GET - /v1/users/<username>/graphs/<graphID>
- に紐付く Pixel をカレンダーヒートマップ形式のSVG画像として取得するためのAPIです。
- 関連リンク
- GET - /v1/users/<username>/graphs/<graphID>.html
- その に関する様々な情報を一覧できる HTML ページを返すAPIです。Webブラウザでリクエストされることを想定しています。
- 関連リンク
3. に関するその他の情報を取得するためのAPI
- GET - /v1/users/<username>/graphs
- 登録済みの の定義情報の配列を取得するためのAPIです。
- GET - /v1/users/<username>/graphs/<graphID>/pixels
- で指定された に登録済みの Pixel を取得するためのAPIです。
- GET - /v1/users/<username>/graphs/<graphID>/stats
- で指定された の統計情報を取得するためのAPIです。
- GET - /v1/users/<username>/graphs/<graphID>/graph-def
- で指定された の定義情報を取得するためのAPIです。
- GET - /v1/users/<username>/graphs/<graphID>/latest
- で指定したグラフに登録されている Pixel のうち、最新の Pixel を取得するためのAPIです。
特徴
には、以下のようなプロパティがあります。
その を一意に識別するための識別子です。その の中で同じ の を作ることはできません。Pixela のグラフなどを表示させる際に、URLの一部としても使われます。また、後から変更することはできません。
その の名称が設定されることを想定したプロパティです。ここで設定した内容は GET - /v1/users/<username>/graphs/<graphID>.html などで確認することができます。
その に投稿される数値の単位が設定されることを想定したプロパティです。例えば、 などです。ここで設定した内容は GET - /v1/users/<username>/graphs/<graphID>.html などで確認することができます。
その に投稿される数値が整数であるか、小数であるかを指定します。 もしくは のいずれかのみが指定可能です。また、後から変更することはできません。
その に紐付く Pixel を表示させたときの色を指定することができます。 のいずれかを指定します。それぞれの色を指定したときの実際の色は、以下の画像を参照してください。
カラースキーマごとの配色のサンプルを確認する
以下のいずれかの手段によって に が投稿された場合、その時の現在日時が用いられます。
その現在日時を取得する際に考慮するタイムゾーンを、このプロパティで設定できます。
ユーザープロフィールページのグラフ一覧表示において、そのグラフを非表示にするかどうかを指定することができるプロパティです。 もしくは を設定します。ただし、 を設定することでグラフを非表示にすることができるのは、Pixelaサポーター限定の機能です。詳しくは Pixela を支援する特典として限定機能を利用可能にする - Pixela サポータープログラム を参照してください。
このプロパティに を設定することで、各 Pixel に記録されている を GET - /v1/users/<username>/graphs/<graphID>.html が返す HTML ページ上で閲覧できるようにしたり、グラフのSVG情報に属性として追加させることができます。ただし、 を設定することでこれらの挙動を有効化できるのは、Pixelaサポーター限定の機能です。詳しくは Pixela を支援する特典として限定機能を利用可能にする - Pixela サポータープログラム を参照してください。
Pixela のグラフを GitHub に埋め込む場合、その画像は自動的に GitHub にキャッシュされます。グラフが更新される度にそのキャッシュをクリアさせたい場合にこのプロパティにURLを設定します。詳しくは GitHub に Pixela のグラフを埋め込む を参照してください。
仕様
- を削除すると、それに紐付く などの情報もすべて削除されます。
留意事項
- を明示的に指定しなかった場合、UTCとして扱われます。
- プロパティを用いてできることは、あくまで一覧表示内容にそのグラフを含めないようにすることだけです。そのグラフのURLを指定しそのグラフを閲覧することを制限することはできません。