Blog

Googleスプレッドシートアドオンの新しいエクスポート機能をリリースしました。これで、Googleスプレッドシートを使用してコンテンツのエクスポートとインポートの両方を行うことができます。この新機能はプロジェクトにどのように役立ちますか？確認してみましょう！

すばらしいGoogleSheetsアドオンについて聞いたことがない場合は、 GitHubリポジトリを参照してチェックしてください。この便利なツールはGoogleスプレッドシートに直接統合されており、既存のコンテンツを更新したり、任意のスプレッドシートから新しいコンテンツアイテムを作成したりできます。これにより、外部システムまたはデータベースからデータを簡単にインポートできます。

これまで、シートから既存のコンテンツアイテムを更新する場合は、行を手動で入力する必要がありました。この新機能を使用すると、すべてのコンテンツアイテムをKontentから既存のデータとともにシートにエクスポートできます。レッツ言うには、例えば、上司は最近、自分の記事の問題を育てたことをサイト-誤っ代わりに、物品のブログに分類要素を設定します！しかし、これらのコンテンツアイテムは数百あり、更新には非常に時間がかかります...これらすべてのアイテムの分類用語をすばやく交換するにはどうすればよいですか？

コンテンツのエクスポート

まず、エクスポート機能とその仕組みを見てみましょう。アドオンを開くと、新しいメニューオプションが表示されます。

エクスポートを実行すると、アドオンによって複数の新しいシートが作成されます。プロジェクトのコンテンツタイプごとに1つずつです。各シートには、ヘッダーやデータなど、そのコンテンツタイプの個々のコンテンツアイテムが含まれています。 Kontentプロジェクトのコンテンツを更新するためにインポートツールを実行するために必要なすべてのもの：

[エクスポート]または[生成]メニューを使用して作成されたシートに追加された新しい列、 rich_text_componentsもあります。この列の詳細については、ここで読むことができますが、一般的な考え方として、この列には、コンテンツアイテムの各リッチテキスト要素に必要なすべてのデータが含まれます。エクスポート機能により、この列が自動的に入力されますが、インポート時に、新規/更新されたコンテンツアイテムの完全なJSONデータを提供することもできます。

別のプロジェクトからコンテンツをインポートする

[エクスポート]メニューに[IDの翻訳]というオプションが含まれていることに気付いたかもしれません。このアドオンは、管理APIを使用してコンテンツアイテムを取得します。コンテンツアイテムは、リンクされたアイテム、分類法などの内部IDを常に返します。つまり、リンクされたアイテムや分類法などの要素の場合、値は次のようになります。id：9b86141d- b667-4c35-82b1-826bc151d72a 。これは人間が読める形式ではなく、2つの異なるプロジェクト間でデータを転送する場合、同じ分類用語のIDは異なります。

[IDの変換]オプションを有効にすると、内部IDがコード名または可能な場合はexternal_idに変換されます。たとえば、前の例のIDは次のようになります： codename：announcements 。つまり、プロジェクトAからすべての記事をエクスポートしてからプロジェクトBにインポートする場合は、次の手順を実行できます。

1. プロジェクトAと同じ要素とコード名を使用してプロジェクトBに記事コンテンツタイプを作成します
2. プロジェクトAと同じコード名と用語を使用してプロジェクトBに分類グループを作成します（例：お知らせ）
3. Googleスプレッドシートで、[エクスポート]メニューを使用して記事をエクスポートし、 [IDの翻訳]オプションを有効にします
4. [プロジェクト設定]メニューで、APIキーをターゲットプロジェクトBに変更します
5. 記事シートを選択してインポートを実行します

例-記事の問題を解決する

スタートに戻りましょう：あなたのマネージャーが誤っ条の代わりにブログにサイトマップ分類用語セットで百記事にタグを付けるためにあなた怒鳴ら覚えていますか？すべての記事を見つけて分類法を正しいものに変更するには時間がかかる可能性があるので、Sheetsアドオンを使用してこれを修正するにはどうすればよいですか？

まず、新しい[エクスポート]メニューを使用して、プロジェクトからすべてのコンテンツアイテムをエクスポートできます。 [IDの翻訳]オプションを必ず有効にしてください。これにより、間違った分類の記事を見つけて正しい値を設定しやすくなります。これにより、すべてのコンテンツタイプに対して複数のシートが生成されますが、心配する必要はありません。他のシートを削除/無視できるように、記事のコンテンツタイプのみを考慮します。

これで、記事シートを選択すると、 codename：blogのような誤った値のサイトマップ列が表示されます。これらすべての参照を1つの簡単な手順で修正するには、[シートの編集]> [検索と置換]メニューに移動し（またはCTRL + Hを押して）、次のメニューを開きます。

間違った参照codename：blogを入力し、codename：articleに置き換えます。 [検索]オプションで、[このシート]を選択して、現在選択されているシートの問題を修正するか、すべてのシートを一度に更新することができます。何をしているのかが確実な場合は、[すべて置換]をクリックしてシートを更新するか、[検索]ボタンを使用して検索語の各出現箇所を表示し、置換するかスキップするかを選択できます。

間違いを修正したので、[インポート]メニューに移動し、[既存のアイテムの更新]が有効になっていることを確認します。記事シートを選択してインポート機能を実行すると、Kontentプロジェクトのすべての記事が、シートの新しいデータで更新されます。インポート後に生成された結果ログをチェックして、すべてがスムーズに実行されたことを確認し、それをマネージャーに見せて、問題をどれだけ迅速に修正したかをマネージャーに印象付けてください。

新しいリリースに関する重要な注意事項！

新機能とアドオンは全体として、1回限りのユーティリティとして使用することも、開発/編集プロセスに統合することもできます。ただし、Googleスプレッドシートのアドオンでは、プロジェクトの完全バックアップは作成されないことに注意してください。管理できるのは、それを使用したコンテンツアイテムのみです。プロジェクトの完全なバックアップ/復元機能を提供するソリューションが必要な場合は、ドキュメントにある他の優れたツールの1つを使用してください。

ツールは最近リリースされたばかりなので、本番環境の前に開発環境で機能をテストすることをお勧めします。また、エクスポート機能は現在、インポート機能と同じバッチ処理プロセスを使用しておらず、Googleの45秒の実行制限が適用されます。何千ものコンテンツアイテムがある場合、リクエストがタイムアウトする可能性があります。

最後に、エクスポート機能のリリースに伴い、分類法などのいくつかの要素の形式が変更されました。以前は、シートにアナウンスや記事などのカンマ区切りのコード名を含めることができました。 このリリースでは、分類法、複数選択、リンクされたアイテム、およびアセット要素は、 GitHubリポジトリで読むことができる同じ形式に従います。