メタ値の許可/拒否リストの定義

カスタム投稿、ユーザー、コメント、タクソノミー（タグとカテゴリー）のメタ値を取得するには、対応するタイプから metaValue（単一の値）および metaValues（値の配列）フィールドをクエリします。

Post.metaValue
Post.metaValues
GenericCustomPost.metaValue
GenericCustomPost.metaValues
User.metaValue
User.metaValues
Comment.metaValue
Comment.metaValues
PostTag.metaValue
PostTag.metaValues
PostCategory.metaValue
PostCategory.metaValues
GenericTag.metaValue
GenericTag.metaValues
GenericCategory.metaValue
GenericCategory.metaValues

また、入力フィールド metaQuery を使用して、カスタム投稿、ユーザー、コメント、タクソノミー（タグとカテゴリー）の結果をメタに基づいてフィルタリングすることもできます。

クエリおよびフィルタリングのどちらの場合も、メタ値はパブリックまたはプライベートのいずれかになります。たとえば、ユーザーメタにはプライベートな wp_capabilities エントリが含まれる一方、description はパブリックです。また、last_name はアプリケーションによってパブリックにもプライベートにもなります。

Gato GraphQL プラグインは、どのメタキーがパブリックでどれがプライベートかを強制しません。これは明示的に設定する必要があります。デフォルトでは、許可されたメタキーのリストは空です。

メタ値のレスポンス

対応する設定ページでアクセスが許可されていないメタキーをクエリすると、クエリはエラーを返します。

たとえば、次のクエリを実行した場合：

{
  post(by: { id: 1 }) {
    id
    metaValue(key: "nothingHere")
  }
}

以下が返されます：

{
  "errors": [
    {
      "message": "There is no meta with key 'nothingHere'",
      "extensions": {
        "type": "Post",
        "id": 1,
        "field": "metaValue(key:\"nothingHere\")"
      }
    }
  ],
  "data": {
    "post": {
      "id": 1,
      "metaValue": null
    }
  }
}