エンティティのアップロードプロセスの詳細 – Yext Help

エンティティアップロードツールを使用すると、スプレッドシートをアップロードしてアカウントにエンティティを一括で更新・追加できます。この項目では、スプレッドシートのアップロードプロセスの概要、気をつけたいベストプラクティス、ファイルのアップロード時に発生する可能性のあるエラーメッセージの一部に関する追加情報を説明します。

この情報をアップロードする手順については、スプレッドシートのアップロードによるエンティティの追加および編集を参照してください。アップロードに含めることのできる各フィールドの詳細は、エンティティのアップロードテンプレートの詳細から確認できます。

エンティティ情報のアップロード（スプレッドシートファイルの準備）

アップロードテンプレートの構成：
- Yextプラットフォームにエンティティが既に存在する場合には、エンティティをエクスポートし、そのファイルを更新して新しいエンティティを追加、または既存のエンティティを更新することをおすすめします。
- アップロードツールが読み取ることができるのはExcelファイルの最初のタブのみです。Excelファイルの最初のタブにプラットフォームにアップロードするエンティティ情報が含まれていることを確認します。
- 同一のファイルでさまざまな種類のエンティティ種類をアップロードすることができますが、エンティティごとに「エンティティ種類」を指定し、エンティティ種類ごとに正しいフィールドを含める必要があります。
エンティティIDまたはYext ID：
- ファイルには識別子カラム（エンティティIDまたはYext ID）を含める必要があります。エンティティIDまたはYext IDを簡単に取得するには、エンティティ情報をエクスポートします。デフォルトでは、これら2つのフィールドはすべてのエクスポートに含まれます。
  - 既存のエンティティを更新する場合には、エンティティIDまたはYext IDのいずれかを含めることができます。
  - 新しいエンティティを追加する場合には、エンティティIDを含める必要があります。エンティティがアップロードされると、Yext IDは自動的に作成されます。
  - イベントを追加する際に、イベントがYextに既に保存されているロケーションに関連付けられている場合には、イベントのエンティティIDと関連付けられた場所のエンティティIDを追加する必要があります。
住所:
- 住所情報をアップロードする場合は、すべての必須の住所フィールドを含める必要があります。必須の住所フィールドは国に固有のものです（また、アップロードテンプレートで「必須」としてマークする必要があります）。米国のエンティティの場合には、次のすべてのフィールドがこれに含まれます。
  - 住所 > 1行目
  - 住所 > 都市
  - 住所 > 地域
  - 住所 > 郵便番号
  - 国/地域
数字フィールド（Yext ID、店舗ID、電話番号など）：
- スプレッドシートファイル内ですべてのIDが数値に変換されていることを確認します。店舗IDや国コードなどのフィールドがテキスト文字列または数字以外の内容として読み取られる場合には、却下される可能性があります。
営業時間：
- 営業時間をアップロードする場合には、週の7日間につきすべての時間を含める必要があります。ただし、祝日営業時間を追加する場合とは異なりますのでご注意ください。
- 営業時間は、開店時刻と閉店時刻の列に分けることができます。ファイルでこのメソッドを使用する場合、Yextフィールド名としては「営業時間>月曜日>開始」、「営業時間>月曜日>終了」などが適切です。

エンティティ情報のマッピング（Yextプラットフォームでのアップロードの構成）

必須フィールドすべてがマッピングされ、新しいエンティティに含める必要があります。必須フィールドの一覧はエンティティの追加：必要なコンテンツとアップロードの形式を参照してください。
Featured Messageはエンティティに必須のフィールドですが、Featured Message URLはオプションです。
アップロードする内容から省きたい列がある場合は、そのフィールドをマッピングせずに、他のすべての列のマッピングが完了したら、Yextプラットフォームで [マッピングされていない行をすべて無視（Ignore All Unmapped Columns）] を選択します。
既存の置き換えと既存への追加の比較
- 複数のサブフィールドがある複数オプション選択フィールドの中には、プラットフォーム内のコンテンツをファイル内のコンテンツで置き換えるようデフォルト設定されているものがあります。
  - これらのフィールドには次のものが含まれます。
    - 複数オプション選択フィールド
      - Googleビジネスプロフィール属性
      - 支払方法
      - ヘルスケア固有のフィールド（入院対応病院、治療疾患、学位など）
    - サブフィールドを有するフィールド
      - 写真ギャラリーフィールド
      - メール
      - ラベル
      - Search Trackerフィールド
      - Enhanced Content Listフィールド
      - 追加属性
- 既存のコンテンツに追加するには、コンテンツを上書きするのではなく、目的の行の右側にある [編集（Edit）] ボタンをクリックし、[既存に追加（Add to Existing）] の横にあるチェックボックスをオンにします。これにより、ファイル内のコンテンツがプラットフォームの既存のコンテンツに置き換わる代わりに、コンテンツがリストに追加されます。
元のアップロードファイルに含まれていないコンテンツを追加するには、[その他のフィールド（Additional Fields）]セクションで [フィールドを追加（Add Field）]をクリックし、必要な情報を入力します。

以下では、各フィールドのフィールドマッピングと、新しいエンティティを追加する際の必須フィールドについての追加情報を説明しています。

エラーの修正

エラーの修正方法には2通りがあり、エラーのある分野によって若干の違いがあります。
- [フィールドビューでエラーを修正（Fix Errors in Field View）] は、住所関連のエラーの場合にのみ表示されます。フィールドビューが表示され、各エンティティの [アドレス（Address）]フィールドに値を追加または編集してすべてのエラーを修正することができます。
- [スプレッドシートビューでエラーを修正（Fix Errors in Spreadsheet View）] をクリックすると、エラーを直接修正できます。クリックすると、確認と修正が必要な問題の一覧が返されます。ファイル内のコンテンツが [ファイル内のデータ（Data in File）] 列の下に、エラーの説明が [エラー（Error）] 列にそれぞれ表示されますので、[新しい値（New Value）]列に正しい情報を入力します。
また、エラーをダウンロードしてエンティティファイル内で修正することもできます。ダウンロードしたファイルのエラー修正を完了したら、新しく修正したファイルを使用してアップロードプロセスを再開します。これを行うには、[その他のアクション（More Actions）] ボタン>[修正後のファイルをアップロードする（Upload Revised File）] の順にクリックし、[ファイルを選択（Choose File）] をクリックして目的のファイルを選択し、[修正後のファイルをアップロードする（Upload Revised File）] をクリックします。

特定のエラーメッセージを読み解く

住所フィールド：
- 住所のエラーは、問題が1つのフィールドに関するものの場合でも表示されます。例えば、以下のインスタンスには未指定の地域（州）があるため、これを「NY」に変更する必要があります。必ず左サイドバーの他のすべてのエンティティの値の追加や編集を終えてから [続行（Continue）] をクリックします。
- エラーメッセージ：
  - 「値は郵便番号形式である必要があります」
  - 「値は有効な地域ではありません」
- 解決策：すべての住所フィールドを含めてマッピングします。
営業時間フィールド：
- エラーメッセージ：
  - 「指定した時間は検証に失敗しました：すべての日の営業時間を指定する必要があります」
- 解決策：すべての曜日に営業時間を入力します。
- エラーメッセージ：
  - 「指定した時間は検証に失敗しました：時間の間隔には、ハイフンを1つのみ含める必要があります」
- 解決方法：営業時間はハイフンを使って時間の間隔として入力する必要があります
  - 例：09:00AM-05:00PM

変更の確認：エンティティグループの用語集

プラットフォームにコンテンツが正常にアップロードされたら、変更内容を確認して確定する必要があります。これらの変更をすべて確認したら、[変更内容を送信（Submit Changes）] をクリックしてアップロードプロセスを完了します。確認が必要な各グループの詳細は以下のとおりです。

新規エンティティ：
- 以前にプラットフォームに存在しなかったエンティティで、アップロードされます。
更新されたエンティティ：
- ファイルに含まれていたプラットフォーム内のエンティティで、その情報に対する1つまたは複数の更新が含まれます。
変更のないエンティティ：
- ファイルに含まれていたプラットフォーム内のエンティティで、コンテンツの更新が含まれません。
欠落しているエンティティ：
- ファイルアップロードに含まれていないプラットフォーム内のエンティティのため、変更されません。