Change: Add Shop User Token, Analytics Queryable, Deprecate Scheduled Changes

The schema now includes a shopUserAccessTokenCreate mutation that accepts a user email and returns a Shop Users API access token, its expiration, a refresh token, token type, and any user errors. New types MetafieldCapabilityAnalyticsQueryable and MetafieldCapabilityAnalyticsQueryableInput expose whether a metafield definition is eligible and enabled for analytics querying. The MetafieldCapabilities type gets an analyticsQueryable field returning the new capability object. The InventoryLevel.scheduledChanges field is marked deprecated and will be phased out in a future release, so clients should avoid relying on it. Clients using shopUserAccessTokenCreate should store the returned token for authenticated requests to the Shop Users API. These changes require developers to update queries to use the new analyticsQueryable field and plan for the removal of scheduled changes support.

Type Changes

➕ Added Types (3)

🏗️MetafieldCapabilityAnalyticsQueryable➕ AddedOBJECT

The analytics queryable capability of a metafield definition.

Fields: eligible, enabled

📥MetafieldCapabilityAnalyticsQueryableInput➕ AddedINPUT_OBJECT

The input fields for the analytics queryable capability.

🏗️ShopUserAccessTokenCreatePayload➕ AddedOBJECT

Return type for shopUserAccessTokenCreate mutation.

Fields: accessToken, expiresIn, refreshToken, tokenType, userErrors

🔄 Modified Types (2)

🏗️InventoryLevel🔄 Modified

🔄 Field modified: scheduledChanges

Before:

📝

Scheduled changes for the requested quantity names.

Type: InventoryScheduledChangeConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: ScheduledChangeSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	example_use
expected_at	time
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
quantity_names	string
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

After:

📝

Scheduled changes for the requested quantity names.

Type: InventoryScheduledChangeConnection!

Arguments:

first: Int -

The first n elements from the paginated list.

after: String -

The elements that come after the specified cursor.

last: Int -

The last n elements from the paginated list.

before: String -

The elements that come before the specified cursor.

reverse: Boolean -

Reverse the order of the underlying list.

sortKey: ScheduledChangeSortKeys -

Sort the underlying list using a key. If your query is slow or returns an error, then try specifying a sort key that matches the field used in the search.

query: String -

A filter made up of terms, connectives, modifiers, and comparators.

name	type	description	example_use
expected_at	time
id	id	Filter by `id` range.	- `id:1234` - `id:>=1234` - `id:<=1234`
quantity_names	string
You can apply one or more filters to a query. Learn more about Shopify API search syntax.

⚠️ Deprecated: Scheduled changes will be phased out in a future version.

🏗️MetafieldCapabilities🔄 Modified

➕ Field added: analyticsQueryable

Indicate whether a metafield definition can be queried in analytics.

Add Shop User Token, Analytics Queryable, Deprecate Scheduled Changes

Mutation Changes

➕ Added Mutations (1)

Type Changes

➕ Added Types (3)

🔄 Modified Types (2)

Add Shop User Token, Analytics Queryable, Deprecate Scheduled Changes

Mutation Changes

➕ Added Mutations (1)

Type Changes

➕ Added Types (3)

🔄 Modified Types (2)

Field Modified: scheduledChanges on InventoryLevel

Before:

After:

Field Modified: `scheduledChanges` on `InventoryLevel`