contentful-managementでエントリーの一覧取得と新規作成をasyncでやってみる

#contentful #javascript

Using async with contentful-management to List and Create Entries

I recently experimented with the JavaScript SDK for contentful-management and wanted to jot down my findings before I forget.

Preparation

Create a Contentful account and space. This article helped me understand the process clearly.

Install the necessary packages for your Node.js project:

npm install dotenv
npm install contentful-management

Create a .env file in the same directory as your package.json and add the following:

personal_access_token=your_personal_access_token
space_id=your_space_id
environment_id=your_environment_id_or_master

You need to create a Personal Access Token specifically for the Contentful Management API, separate from the Delivery and Preview API keys. For details, check the official page.

Retrieving a List of Entries from Contentful

In Contentful, each piece of data is called an entry, similar to a record in a relational database.

Here's the source code to obtain a list of entries:

require('dotenv').config()
const env = process.env

process.on('unhandledRejection', console.dir);

const contentful = require('contentful-management')
const client = contentful.createClient({
    accessToken: env.personal_access_token
});

(async () => {
    const space = await client.getSpace(env.space_id);
    const environment = await space.getEnvironment(env.environment_id);
    const entries = await environment.getEntries();
    entries.items.forEach(item => console.log(item));
})();

Registering an Entry in Contentful

A content model in Contentful is akin to a table in a database. We will create a new entry in this model. First, create it as a draft, and then publish it.

Here's the source code:

The fields section varies depending on your content model, so adjust as necessary. If you've changed Contentful's Settings > Locales to ja, replace en-US with ja.

require('dotenv').config()
const env = process.env

process.on('unhandledRejection', console.dir);

const contentful = require('contentful-management')
const client = contentful.createClient({
    accessToken: env.personal_access_token
});

(async () => {
    const space = await client.getSpace(env.space_id);
    const environment = await space.getEnvironment(env.environment_id);

    const draftEntry = await environment.createEntry('hoge_content_type', {
        fields: {
            id: {
                'en-US': 'hoge_id'
            },
            name: {
                'en-US': 'hoge_name'
            }
        }
    });

    try {
        const publishedEntry = await draftEntry.publish();
        console.log(`Published entry ID: ${publishedEntry.sys.id}`);
    } catch (err) {
        console.error(err);
    }
})();