📈

Graph

This equals to an object that the posted Pixels are displayed in the form of a calendar heatmap, or configuration properties related to its display content.

Related API

There are a total of 9 APIs related to , which can be categorized into the following 3 types:
  1. APIs for creating and deleting and updating their properties
  1. APIs for displaying
  1. APIs for retrieving the other information about

1. APIs for creating and deleting and updating their properties

2. APIs for displaying

3. APIs for retrieving the other information about

Properties and features

has the following properties:

This is an identifier for uniquely identifying the . You can’t create a that has the same in a certain . This is also used as part of the URL when you display a Pixela graph. Additionally, you can’t change this property after.
When pointing to this property in the API document, this is often referred to as .

This is a property that is expected to be set a name of the . You can confirm its content by GET - /v1/users/<username>/graphs/<graphID>.html, etc.

This property is expected to be set the unit of the quantity posted to the .
For example, it is , , or . You can confirm its content by GET - /v1/users/<username>/graphs/<graphID>.html, etc.

You need to specify whether the value which is posted to the is an integer or decimal value by setting this property. Additionally, you can’t change this property after.

You can specify the color of Pixels associated with the when it is displayed.
You can specify , , , , , or to this property as its color. How is the color when you specify the each color scheme, please see the following images:
Confirm the color sample of each color scheme
shibafu (芝生 / green)
(芝生 / green)
momiji (紅葉 / red)
(紅葉 / red)
sora (空 / blue)
(空 / blue)
ichou (銀杏 / yellow)
(銀杏 / yellow)
ajisai (紫陽花 / purple)
(紫陽花 / purple)
kuro (黒 / black)
(黒 / black)

When a is posted to in one of the following ways, using current date at that time.
By setting the property, you can specify the time zone that is considered when getting the current date.
You can confirm its content by GET - /v1/users/<username>/graphs/<graphID>.html, etc.

You can specify one of the , , or value to this property.

By setting this property, you can specify whether hide the graph or not on the graphs list on your user profile page. Specifying or to this property.
However, the feature that hides the graph by setting is only available to Pixela Supporters. For more detail, please see 💝Make exclusive features available as a benefit of supporting Pixela - Pixela Supporter Program.

By setting to this property, you can make recorded in each Pixel viewable on the HTML page which GET - /v1/users/<username>/graphs/<graphID>.html returns, and you can have it added as an attribute to a graph’s SVG information.
However, the feature that enables these behaviors by setting is only available to Pixela Supporters. For more detail, please see 💝Make exclusive features available as a benefit of supporting Pixela - Pixela Supporter Program.
About how to use this feature or for more detail, please see 💬Add and display an additional information to Pixel.

When a Pixela graph is embedded on GitHub, the image is cached in GitHub automatically. If you want to clear the cache every updating the graph, you can do it by setting the cached image URL to this property.
For more detail, please see Embedding Pixela graphs in GitHub.

Specifications

  • When you delete a , all data, such as pixels, associated with it also will be deleted.

Notes

  • If you don’t explicitly specify , it’s treated as UTC.
  • What by using property is only making the graph removed from a graph list content.
  • The only thing you can do with the property is to remove the graph from a graph list content. You can’t prevent access to the graph by specifying URL directly.

Related links