Getting started

​
Manage measurement settings and saved filters

Authenticate with permission to change measurement settings. Confirm the target workspace before you continue.

​
Read the current settings

orc workspaces measurement-configurations get --workspace WORKSPACE_ID --json

The API returns 404 when the workspace does not have a configuration. Confirm that you selected the intended workspace before you create one.

​
Update the measurement configuration

printf '%s' '{"default_location":{"level":"country","code":"JP"},"default_language":"ja-JP","platform_selection":{"mode":"explicit","ids":["MODEL_ID"]}}' \
  | orc workspaces measurement-configurations update --workspace WORKSPACE_ID --stdin --json
orc workspaces measurement-configurations get --workspace WORKSPACE_ID --json

An update appends a configuration revision and makes that revision active. A failed update leaves the previous active configuration unchanged. Read the result and confirm that the location, language, and model IDs match your intended values.

​
Inspect configuration revisions

orc workspaces measurement-configurations revisions list --workspace WORKSPACE_ID --limit 20 --json

If the response includes a next cursor, pass it with --cursor CURSOR to read the next page.

​
Save and read back a filter

printf '%s' '{"name":"Japan model filter","filter":{"countries":["JP"],"models":["MODEL_ID"],"tags":["TAG_ID"]}}' \
  | orc saved-views create --workspace WORKSPACE_ID --stdin --json
orc saved-views list --workspace WORKSPACE_ID --json

A saved view stores its name and filter. Compare the create and list responses to confirm that nested filter fields remain unchanged.

workspaces reference · saved-views reference · Workflow index