GraphQLクエリ

SearchはIDの資産のために

以下のクエリは、特定のID(asset.alexander-mils-667996)を持つM_Assetエンティティタイプから単一の資産に関するデータを取得します。

{ m_Asset(id: "asset.alexander-mils-667996") { fileName title createdOn } }

結果は以下の通りです。

{ "data": { "m_Asset": { "fileName": "alexander-mils-667996.jpg", "title": "Elderflower cordial", "createdOn": "2022-11-03T04:`27

Search by definition

以下のクエリはM_Contentエンティティタイプからデータを取得し、各エンティティのidとcontent_Nameを返します。

{ allM_Content { results { id content_Name } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "results": { "id": "tTMVYivL2UyM3300lnraRQ", "content_Name": "Fruitful Summer (gb)" }, { "id": "LB0MQmR3U0ST9NX2V4L_vA", "content_Name": "Fruitful Summer (es)" }, { "id": "TmYSxnfrqUWL1-1VEL-ZdA", "content_Name": "Fruitful Summer (us)" }, { "id": "Content.PowerofProtein", "content_Name": "The Power of Protein" }, { "id": "Content.Snacking", "content_Name": "Snacking" }, { "id": "Content.SalsaWithFruitChips", "content_Name": "Flavorful's famous salsa with Healthful fruit chips" }

} } }

インターフェースからのリゾルブ型

Interfaceは、インターフェースを実装するために型が含めなければならない特定のフィールドセットを含む抽象型です。これはContent Hubで定義されたContentTypesエンティティのみで利用可能です。

以下のクエリは、Fruitful Email、Fruitful Blog、またはHealthy Mimosaを含む名前を持つエンティティをM.Contentから取得します。

query contentEmailBlogInterface { allM_Content( where: { OR: { content_Name_contains: "Fruitful Email" } { content_Name_contains: "Fruitful Blog" } { content_Name_contains: "Healthy Mimosa" }

} ) { total results { content_Name ... on M_Content_Blog { blog_Title blog_Body } ... on M_Content_Email { email_Subject email_Body } } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "total": 5, "results": { "content_Name": "Fruitful Blog", "blog_Title": "Fruitful juices", "blog_Body": " figure class=\"image\" img width=\"150\" alt=\"Fruitful logo (black)\" src=\"https://stylelabsdemo.com/api/public/content/363909544a354d3b9a4549c306c88bbe?v=ad464f64\\" /figure p br   /p p i strong Un tonto se cree sabio, pero un hombre sabio sabe que es un tonto. /strong /i /p figure class=\"image\" img width=\"200\" alt=\"Fruitful Orange mocktail\" src=\"https://stylelabsdemo.com/api/public/content/0268acbebdb643aa83d918ff8d03283d?v=f3607a38\\" /figure p style=\"text-align

} } }

これらの結果には、仮想M_Content_Blogタイプのコンテンツ名フィールド、ブログタイトルおよび本文フィールド、仮想M-Content_Emailタイプのメール件名および本文フィールドが含まれます。クエリでタイプに ... on Typeを付けて、インターフェースが返された際にコンテンツタイプの修飾子を作成することで、これらの包含を要求できます。

合計

totalフィールドは指定された条件に合致するエンティティの数を返します。

以下の例では基準が指定されていないため、クエリはM.Content内のエンティティの総数を返します。

{ allM_Content { total } }

結果は合計23の実体を示しています。

{ "data": { "allM_Content": { "total": 23 } } }

ここで

クエリにwhere節を追加することで、ANDやORのような論理演算子や、次のような後置辞を含むカスタム基準に基づいて結果数を制限できます。

• _eq
• _neq
• contains
• fulltext

に等しい

以下の例には、資産titleが特定のフレーズと等しくなければならないというwhere条項が含まれています。

query AssetTitle { allM_Asset(where: { title_eq: "Group selfie with drinks" }) { total results { fileName title fileSize isDraft } } }

結果は以下の通りです。

{ "data": { "allM_Asset": { "total": 1, "results": { "fileName": "videoblock-example3.mp4", "title": "Group selfie with drinks", "fileSize": 10.08, "isDraft": null }

} } }

と等しくありません

以下の例には、資産isDraft財産の価値がnullでない価値を持たなければならないと明記するwhere条項が含まれています。

query AssetDraftIsNotNull { allM_Asset(where: { isDraft_neq: null }) { total results { fileName fileSize isDraft } } }

結果は以下の通りです。

{ "data": { "allM_Asset": { "total": 1, "results": { "fileName": "videoblock-example3.mp4", "fileSize": 10.08, "isDraft": true }

} } }

包含

containsポフィックスを使って、指定されたフィールド内のフレーズを検索してください。このポステフィックスは単一のフィールドにのみ適用されます。

以下の例には、content_Nameプロパティに次の項Fruitfulを含めることを指定するwhere節が含まれています:

{ allM_Content(where: { content_Name_contains: "Fruitful" }) { total results { content_Name m_Content_IsVariant } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "total": 7, "results": { "content_Name": "Sparkling Punch using Fruitful Orange", "m_Content_IsVariant": null }, { "content_Name": "Fruitful Summer (us)", "m_Content_IsVariant": true }, { "content_Name": "Fruitful Summer (gb)", "m_Content_IsVariant": true }, { "content_Name": "Fruitful Summer (es)", "m_Content_IsVariant": null }, { "content_Name": "Fruitful refreshing ginger lemonade", "m_Content_IsVariant": null }, { "content_Name": "Fruitful Cocktails", "m_Content_IsVariant": null }, { "content_Name": "Fruitful Mocktails", "m_Content_IsVariant": null }

} } }

運用者

containsポフィックスで使える他のオペレーターもあります。

• fieldname_in - 定義された潜在的な値のリストに現れる値をチェックすること。
• fieldname_startswith 特定の文字列で始まる値をチェックします。
• fieldname_endswith 特定の文字列で終わる値をチェックします。

完全なリストを見るには、GraphQL IDEの「 スキーマ 」タブをクリックしてください。

ほとんどの演算子には、指定された条件に合わない値を探す逆バージョンが含まれています。例えば、fieldname_not_containsはfieldname_containsの反対です。

全文検索

全文検索を行うには、where節のfulltextを使用します。containsポフィックスとは異なり、fulltextは関連するエンティティのすべてのフィールドおよび全文検索対象の先祖に関連する関連する特定の単語やフレーズを検索します。検索されるフィールドは、Content Hubで全文プロパティとして設定されているものです。

以下の例は、任意の検索可能なフィールドでM.Assetに「 fruitful lemon 」というフレーズを問い合わせます。

query { allM_Asset(where: { fulltext: "fruitful lemon" }) { results { title } } }

結果は以下の通りです。

{ "data": { "allM_Asset": { "results": { "title": "Fruitful Lemon mocktail with dried lemon slices-9926" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9837" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9748" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9659" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9570" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9481" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9392" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9303" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9214" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9125" }

} } }

fulltextは他の接頭辞と組み合わせることができます。例えば:

query { allM_Asset(where: { fulltext: "Fruitful Lemon mocktail with dried lemon slices" title_contains: "92" }) { results { title } } }

結果は以下の通りです。

{ "data": { "allM_Asset": { "results": { "title": "Fruitful Lemon mocktail with dried lemon slices-9926" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9392" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-9214" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-5921" }, { "title": "Fruitful Lemon mocktail with dried lemon slices-492" }

} } }

順序付け

orderByキーワードを使って、結果セットを特定の順序で並べ替えてください。

以下のクエリはレシピタイトルで結果を並べ替えます。 _DESCや _ASCを付け加えて、並べ順を降順または昇順に指定できます。

{ allM_Content_Recipe( where: { recipe_Title_contains: "Fruitful" } orderBy: RECIPE_TITLE_ASC ) { total results { recipe_Title } } }

結果は以下の通りです。

{ "data": { "allM_Content_Recipe": { "total": 4, "results": { "recipe_Title": "Fruitful mango mocktail" }, { "recipe_Title": "Fruitful refreshing ginger lemonade as an alternative to soda" }, { "recipe_Title": "Fruitful's famous salsa with Healthful fruit chips" }, { "recipe_Title": "Sparkling Punch using Fruitful Orange" }

} } }

論理演算子

文を組み合わせるためにANDやOR論理演算子を使い、クエリに高度な論理を組み込むことができます。

タイプネーム

__typenameフィールドには、そのオブジェクトのGraphQLスキーマタイプの名前が含まれています。例えば:

query typeName { allM_Content(where: {content_Name_contains: "Mimosa"}) { total results{ content_Name __typename } } }

複数クエリの実行

1つのリクエストで複数のクエリを実行することができます。クエリ同士には影響がありません。以下の例では、同時に2つのクエリが実行されています:

• 最初のクエリ(Blog)は、仮想ブログタイプを用いて M.Contentを検索し、タイトルに Fruitful が入り、本文が nullでないブログを探します。結果はブログタイトルの昇順に並べます。
• 2つ目のクエリ(Email)は、 M.Contentで仮想メールタイプを使い、タイトルに Fruitful があり、本文が nullでないメールを探します。結果をメールタイプごとに昇順に並べます。

query contentEmailBlog { allM_Content_Blog( where: { blog_Title_contains: "Fruitful", blog_Body_neq: null } orderBy: BLOG_TITLE_ASC ) { total results { blog_Title blog_Body blog_Quote } }

allM_Content_Email( where: { email_Subject_contains: "Fruitful", email_Body_neq: null } orderBy: EMAIL_SUBJECT_ASC ) { total results { email_Subject email_Body } } }

これら2つのクエリの結果は、単一のオブジェクトにまとめられ、以下の通りです。

{ "data": { "blog": { "total": 3, "results": { "blog_Title": "Fruitful blog", "blog_Body": " p There is no one who loves pain itself, who seeks after it and wants to have it, simply because it is pain. There is no one who loves pain itself, who seeks after it and wants to have it, simply because it is pain. There is no one who loves pain itself, who seeks after it and wants to have it, simply because it is pain /p figure class=\"image\" img width=\"1100\" alt=\"Refreshing mocktails\" src=\"https://stylelabsdemo.com/api/public/content/2ed85585609c43bda24ae92372a5f311?v=f4d87d58\\" /figure ", "blog_Quote": " p The strong fruit /strong of your own hard work is the sweetest. /p " }, { "blog_Title": "Fruitful blog", "blog_Body": " p Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi pulvinar tellus non augue vestibulum vulputate. Proin non tortor vitae ante tincidunt dictum eget vitae tortor. /p figure class=\"image\" img width=\"1100\" alt=\"Refreshing mocktails\" src=\"https://stylelabsdemo.com/api/public/content/2ed85585609c43bda24ae92372a5f311?v=f4d87d58\\" /figure ", "blog_Quote": " p br Le fruit de votre propre travail acharné est le plus doux. /p " }, { "blog_Title": "Fruitful blog", "blog_Body": " p Lorem ipsum dolor sit amet, consectetur adipiscing elit. Morbi pulvinar tellus non augue vestibulum vulputate. Proin non tortor vitae ante tincidunt dictum eget vitae tortor. /p figure class=\"image\" img width=\"1100\" alt=\"Refreshing mocktails\" src=\"https://stylelabsdemo.com/api/public/content/2ed85585609c43bda24ae92372a5f311?v=f4d87d58\\" /figure ", "blog_Quote": " p br El fruto de tu propio trabajo duro es el más dulce. /p " }

}, "email": { "total": 1, "results": { "email_Subject": "Fruitful Late Summer Email", "email_Body": " p br strong Fruitful:  /strong /p p No hay nadie que ame el dolor mismo, que lo busque y quiera tenerlo, simplemente porque es dolor. /p figure class=\"image\" img width=\"1100\" alt=\"Product layer 3\" src=\"https://stylelabsdemo.com/api/public/content/c8cc3c37df854f9c92c0ddef0795198d?v=0039f433\\" /figure " }

} } }

カーソルベースのページ分け

カーソルベースのページ割り当ては、データセット内の特定の項目へのポインタを返します。その後のリクエストでは、サーバーは指定されたポインタの後に結果を返します。

まず

firstの引数はクエリが返す結果の数を制限します。この引数の値は1,000未満でなければなりません。デフォルト値は10です。次の例では、結果の上限は2つです。

query firstTwo { allM_Content(first

} } }

first引数がなければ、このクエリは28のエントリを返します。first引数を2に設定すると、結果には最初に見つかった2つの実体のみが含まれます。

{ "data": { "allM_Content": { "total": 28, "results": { "id": "BDolxU3bGkWMwFJk-s8Idg", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }, { "id": "igADXjecyk2oF4lo_tfs2Q", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }

} } }

ページ情報

pageInfo型にはページ付けに必要な情報が含まれています。

endCursor

endCursorフィールドは、現在のページの最後のエンティティに関連付けられたカーソルを表します。

!注カーソルは不透明で、クライアントが操作することを意図していません。

query endCursor { allM_Content(first: 5) { total results { id content_Name m_Content_IsVariant } pageInfo { endCursor hasNext } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "total": 28, "results": { "id": "BDolxU3bGkWMwFJk-s8Idg", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }, { "id": "igADXjecyk2oF4lo_tfs2Q", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }, { "id": "p70lTBrPSkqTZ2Ky3BdmWw", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }, { "id": "9zjJfWK_UkSoX8Gd1I8dPg", "content_Name": "Fruitful Summer", "m_Content_IsVariant": null }, { "id": "OwuHPqtSNk25OF6CPz6s8A", "content_Name": "Fruitful Juices", "m_Content_IsVariant": null } , "pageInfo": { "endCursor": "eyJzZWFyY2hBZnRlciI6WyIxNjEzNzMyMDk1MTcyIl0sImNvdW50Ijo1fQ==", "hasNext": true } } } }

hasNext

hasNextは、他にも利用可能な結果があるかどうかを示すブール値です。

query hasNext { allM_Content(first: 2) { total results { id content_Name m_Content_IsVariant } pageInfo { hasNext } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "total": 28, "results": { "id": "BDolxU3bGkWMwFJk-s8Idg", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true }, { "id": "igADXjecyk2oF4lo_tfs2Q", "content_Name": "Fruitful Summer (es-ES)", "m_Content_IsVariant": true } , "pageInfo": { "hasNext": true } } } }

!注hasNexttrueなので、返却されなかった結果が他にも存在します。

その後

afterパラメータは、全体のデータセットの特定のポイント以降に発生した結果のみを返すことができます。このポイントはカーソルで決定され、endCursorの引数を含むクエリで得られます。次のクエリでは、ページングはコンテンツ項目eyJzZWFyY2hBZnRlciI6WyIxNjEzNzMyMDk1MTcyIl0sImNvdW50Ijo1fQ==の後に始まります。

query afterEndCursor { allM_Content( first: 5 after: "eyJzZWFyY2hBZnRlciI6WyIxNjEzNzMyMDk1MTcyIl0sImNvdW50Ijo1fQ==" ) { total results { id content_Name m_Content_IsVariant } pageInfo { endCursor hasNext } } }

結果は以下の通りです。

{ "data": { "allM_Content": { "total": 28, "results": { "id": "wT5RNeIcQ0SHTORNT1faug", "content_Name": "Fruitful Summer (it-IT)", "m_Content_IsVariant": true }, { "id": "Content.SalsaWithFruitChips", "content_Name": "Flavorful's famous salsa with Healthful fruit chips", "m_Content_IsVariant": null }, { "id": "Content.PowerofProtein", "content_Name": "The Power of Protein", "m_Content_IsVariant": null }, { "id": "Content.PowerFromWithin", "content_Name": "Power comes from within", "m_Content_IsVariant": null }, { "id": "Content.FruitfulGinger", "content_Name": "Fruitful refreshing ginger lemonade", "m_Content_IsVariant": null } , "pageInfo": { "endCursor": "eyJzZWFyY2hBZnRlciI6WyIxNjEzMzY0Nzg0MTk4Il0sImNvdW50IjoxMH0=", "hasNext": true } } } }