amp charts
このページはまだあなたの言語に翻訳されていません。 現在取り組んでいますので、後でもう一度確認してください。
amp charts lists, inspects, and queries saved charts. This read-only command family requires the analytics:read scope.
amp charts list
Returns saved charts in the project. Results are paginated with cursor-based pagination. Chart definitions are omitted; use GET chart with include_definition=true to retrieve a read-only definition.
Pagination uses an opaque numeric cursor (offset into the current sorted search result set). Each list query can access at most 10,000 matching charts from the search index; pages beyond that window return fewer items and next_cursor: null even when more charts may exist in the project. Use filters (q, chart_type) to narrow large projects.
Sortable fields are updated_at and name; prefix with - for descending. Defaults to -updated_at (most recently updated first). created_at is not supported in this API version.
amp charts list --project <project_id> --limit 5
amp charts list --project <project_id> --chart-type funnels --sort -updated_at
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--cursor | string | No | Opaque cursor from pagination.next_cursor on the previous response. Numeric offsets are capped by the underlying search index (10,000 results per query). Well-formed pagination stops before that window; requests whose cursor would exceed it return 400 pagination_not_supported. Alias: --next-cursor. |
--limit | integer | No | Number of items to return. Defaults to 50, max 200. |
--q | string | No | Full-text search query. Alias: --query. |
--chart-type | string | No | Filter list results to a specific chart type. Use unknown to return charts whose type is not represented by a public API value. Alias: --type. |
--sort | string | No | Sort field. Prefix with - for descending. Supported values are updated_at and name. |
Requires the analytics:read scope.
amp charts get
Returns chart metadata. The chart definition is omitted by default. Set include_definition=true to include a read-only definition object. The definition shape is unstable and not intended for authoring.
amp charts get --project <project_id> --chart <chart_id>
amp charts get --project <project_id> --chart <chart_id> --include-definition
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--chart | string | Yes | Saved chart identifier. Alias: --chart-id. |
--include-definition | boolean | No | When true, include the read-only chart definition on GET chart. The definition shape is unstable and not intended for authoring. |
Requires the analytics:read scope.
amp charts query
Computes and returns normalized results for a saved chart. v1 supports event_segmentation, sessions, funnels, and retention chart types; other chart types return 422 with error_code: unsupported_chart_type. Results reflect the authenticated caller's project access and chart permissions.
This POST computes a result and does not mutate state. It is therefore a read operation and does not require an Idempotency-Key.
Omitting time_range uses the chart's saved range; if the chart has no saved range, the server defaults to the last 30 days.
Query is synchronous with bounded defaults. Expensive queries may return 504 when exceeding the server timeout; async query jobs are planned for a follow-up slice. Retryable responses may include retry advice where their endpoint-specific error contract provides it.
amp charts query --project <project_id> --chart <chart_id>
amp charts query --project <project_id> --chart <chart_id> \
--time-range '{"start":"2026-07-01","end":"2026-07-31"}' \
--timezone America/Los_Angeles
| Flag | Type | Required | Description |
|---|---|---|---|
--project | string | Yes | Amplitude project identifier, backed by the canonical app ID. Alias: --project-id. |
--chart | string | Yes | Saved chart identifier. Alias: --chart-id. |
--time-range | object | No | |
--timezone | string | No | IANA timezone identifier (e.g. America/New_York). |
--exclude-incomplete-datapoints | boolean | No | When true, excludes the current incomplete interval from results. |
--group-by-limit | integer | No | Maximum number of breakdown groups returned per series. |
--time-series-limit | integer | No | Maximum number of time buckets per series. 0 collapses each series to a single scalar aggregate. |
Requires the analytics:read scope.
これは役に立ちましたか?
For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.