如何通过 Contentful Delivery API 查看内容条目的语言环境

Question

我正在 Contentful Delivery API 中运行查询，以根据其 slug 返回特定页面项目。此查询还设置了语言环境，以便它只返回我需要呈现的语言的数据。

不过，我还需要设置页面的 hreflang 标记，以帮助 google 知道该页面也提供其他语言版本。

我从内容内容中得到的表示我的页面的内容项的响应似乎没有任何类型的数组属性，让我可以轻松确定内容可用的其他语言。

我假设这一定是 SEO 的一个非常普遍的要求，所以希望有人能告诉我如何在 Contentful 的响应中得到这个？

这是我的回应示例。我希望看到的是另一个名为 allLocales 的属性，它会列出可以提供此内容的每个语言环境。

更新： 我知道我可以获得空间中所有语言环境的列表，并在我的查询中设置locales=*，但这仍然无济于事。我只需要知道我检索到的给定内容中可用的语言环境子集。例如，一个页面可能只支持 2 个语言环境，但整个空间中可能有 3 个或更多语言环境可用。

Locales=* 没有帮助，因为它包含每个链接项（可能有也可能没有内容）的语言环境，而我需要的是一个数组对象，其中包含父内容项上可能可用的所有语言环境.即使用户没有将内容放在字段中，我也想明确地知道是否已在内容上选择了语言环境。

{
    "sys": {
        "type": "Array"
    },
    "total": 1,
    "skip": 0,
    "limit": 1,
    "items": [
        {
            "sys": {
                "space": {
                    "sys": {
                        "type": "Link",
                        "linkType": "Space",
                        "id": "xuehyxrgb9ri"
                    }
                },
                "id": "1MhAzkNYvOSU8GgUQcQKqa",
                "type": "Entry",
                "createdAt": "2018-01-05T10:48:30.373Z",
                "updatedAt": "2018-01-05T12:57:00.066Z",
                "revision": 6,
                "contentType": {
                    "sys": {
                        "type": "Link",
                        "linkType": "ContentType",
                        "id": "contentPage"
                    }
                },
                "locale": "en-AU"
            },
            "fields": {
                "title": "Test Page",
                "slug": "test-page",
                "content": [
                    {
                        "sys": {
                            "type": "Link",
                            "linkType": "Entry",
                            "id": "Vt4ktGvOE0qoO8mqeCMao"
                        }
                    },
                    {
                        "sys": {
                            "type": "Link",
                            "linkType": "Entry",
                            "id": "2jY5LUgHWUsaIyMuwKwYe2"
                        }
                    }
                ]
            }
        }
    ]
}

Answer 1

如果您请求当前空间，您可以实现这一目标

https://cdn.contentful.com/spaces/<you-space-id>

你会得到类似这样的回应：

{
  "sys": {
    "type": "Space",
    "id": "developer_bookshelf"
  },
  "name": "Developer Bookshelf",
  "locales": [
    {
      "code": "en-US",
      "default": true,
      "name": "U.S. English",
      "fallbackCode": null
    },
     {
      "code": "de-DE",
      "default": false,
      "name": "German (Germany)",
      "fallbackCode": null
    }

  ]
}

其中包含语言环境数组。

此外，如果您想获取包含所有语言环境的条目，您只需将 locale 查询更改为 locale:*。

此外，您还可以使用js SDK 实现这一目标

var contentful = require('contentful')
var client = contentful.createClient({
  // This is the space ID. A space is like a project folder in Contentful terms
  space: '<space-id>',
  // This is the access token for this space. Normally you get both ID and the token in the Contentful web app
  accessToken: '<access-token>'
})
// This API call will request an entry with the specified ID from the space defined at the top, using a space-specific access token.
const space = await client.getSpace()
console.log('space--------------------')
console.log(space)

const localizedEntries = await client.getEntries({locale: '*'})
console.log('localizedEntries--------------------')
console.log(localizedEntries)

Answer 2

要以编程方式确定给定页面可用的语言列表，您可以对 /entries?content_type=contentPage&fields.slug=test-page&locale=en-AU 进行初始查询以获取页面的全部内容（包括引用的条目），然后获取顶部条目的 ID 并生成/entries/<ENTRY_ID>?locale=* 的另一个 API 请求并获取响应的 fields.<LOCALIZED_FIELD> 的密钥。

如果给定页面可用的语言列表是编辑决定，我建议添加一个新字段，一个简短的文本列表，使用可能语言的完整列表设置预定义值验证，并使用复选框外观。然后作者/编辑可以选择页面可用的语言，您可以简单地访问该字段以获取语言数组。

Answer 3

您可以通过查询空间来检索包含所有空间语言环境及其配置的数组（例如default 和fallbackCode）的语言环境对象：

https://www.contentful.com/developers/docs/references/content-delivery-api/#/reference/spaces/space/get-a-space/console/js