Q. GridsomeでAPIから読み込んだデータにrefをつけるには？

CollectionにaddReferenceを付与すれば作成されます

GridsomeにAPIからデータを挿入するときは、

const articles = actions.addCollection

でコレクションを作成しますが、作成した後に、

articles.addReference('tags', 'Tags')
articles.addReference('category', 'Categories')

という形でrefを付与します。これは、「@gridsome/source-filesystem」のrefsに相当します。

addReferenceは、

1. 第一引数：collection内のキー
2. 第二引数：参照するCollection

を指定します。

refsが作成されているので、GraphQLのfilterやbelongsToで、記事の絞り込みが可能になります。