---
lang: ja-jp
breaks: true
---
# Shopify GraphQL に関するあれこれ 2022-12-28

## Graphql schema documentation

https://2fd.github.io/graphdoc/shopify/

:::warning
Shopify API Demos.
> 2fd/graphdoc
> https://github.com/2fd/graphdoc#demos
※あくまでもデモなので、おそらく情報が古い。
:::

## GraphQL Admin API reference
https://shopify.dev/api/admin-graphql

## Rate limits

https://shopify.dev/api/admin-graphql#rate_limits

:::info
GraphQL Admin APIは、計算されたクエリコスト（コストポイント）を使用した料金制限を設けています。クエリが返す各フィールドには、設定されたポイント数のコストがかかります。クエリの総コストは、返されるすべてのフィールドの合計であるため、複雑なクエリを実行するほどコストが高くなります。

APIは、1つのアプリにつき1ストアで1分間に最大1000ポイントのコストポイントをサポートします。このクォータは、1秒間に50コストポイントの割合で補充されます。
:::

:::warning
利用制限
本APIは、1アプリ1店舗につき1分間に最大1000点のコストポイントをサポートします。
:::

:::info
ほとんどのフィールドは1ポイントです。ほとんどの変異のコストは10ポイントです。クエリの本当のコストを知るには、クエリを実行するのが一番です。APIレスポンスには、クエリの総コストとクライアントの現在のクォータに関する情報がextensionsキーの下に含まれています。`X-GraphQL-Cost-Include-Fields':true` ヘッダーを含めると、クエリコストのより詳細な内訳を受け取ることができます。
:::

###### 通常

・・・
  "extensions": {
    "cost": {
      "requestedQueryCost": 12,
      "actualQueryCost": 10,
      "throttleStatus": {
        "maximumAvailable": 1000.0,
        "currentlyAvailable": 990,
        "restoreRate": 50.0
      }
    }
  }
・・・

###### h6 `X-GraphQL-Cost-Include-Fields':true` ヘッダーを含めた場合

> GraphQL Admin API rate limits
> https://shopify.dev/api/usage/rate-limits#graphql-admin-api-rate-limits

## Shopify API検索構文

https://shopify.dev/api/usage/search-syntax

###### tags: `Shopify` `GraphQL`