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.

bash
amp charts list --project <project_id> --limit 5
amp charts list --project <project_id> --chart-type funnels --sort -updated_at

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.

bash
amp charts get --project <project_id> --chart <chart_id>
amp charts get --project <project_id> --chart <chart_id> --include-definition

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.

bash
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

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.

このページでは