Yextでは、Googleのライブラリであるlibphonenumberを使用してYext Content内の電話番号データの解析と検証を行っています。libphonenumberにより電話番号が無効と判断されると、その電話番号はContent内のエンティティに保存されなくなります。この記事では、Yext Contentへの追加がブロックされた電話番号のトラブルシューティングと検証の手順を説明します。

電話番号の検証

Content内のエンティティへの電話番号の追加がブロックされており、かつその電話番号が有効であると思われる場合は、次の方法でトラブルシューティングを行うことができます。

1. libphonenumberデモで電話番号をテストします。
   1. ステップ1で、[電話番号を指定（Specify a Phone Number）] フィールドに1つの電話番号を入力するか、複数の電話番号のCSVファイルをアップロードします。
      1. 電話番号は、書式設定ありまたはなしで入力でき、国コードの数値も入力できます。例えば、Yextの会社電話番号をテストするには、「(212) 994-3900」、「+1 (212) 994-3900」、または「2129943900」と入力します。これらのどの形式でも使用できます。
         • 注：複数の電話番号のファイルをアップロードする場合は、すべての番号が同じ国コードに対応している必要があります。
   2. ステップ2で対象の電話番号の2文字の国コードを入力します。
      1. これにはISO 3166 alpha-2コード（米国の場合は「us」）を使用します。これらの国番号の一覧はこちらで参照できます。
   3. （オプション）ステップ3では電話番号ジオコーディング用のロケール（電話番号が登録されている国の言語）を入力できます。この手順は必須ではなく、入力しない場合はデフォルトで英語となります。
      1. 最初のボックスに有効なISO言語コード（一覧はこちら）を入力します。
      2. 複数の国で使われている言語を入力する場合は、2番目のボックスで地域をさらに指定できます（アメリカ英語とイギリス英語など）。ステップ2で使用したものと同じISO国コードで地域を指定します（アメリカ英語を指定する場合なら、言語コードは「en」、国コードは「us」）。このボックスは空白のままでも構いません。
         
2. デモでは、入力した電話番号に関する情報が返されます。検証結果の表は以下で参照できます。
   1. 1. 1. isPossibleNumber()の結果：指定された国でこの電話番号を保有することができる場合、これはtrueとなります。
            1. 例えば、米国の電話番号はすべて、国番号「+1」を含めて11桁です。国コードが「us」で12桁の電話番号が入力された場合、この番号が米国に存在する可能性はないため、このフィールドはfalseとなります。
         2. isValidNumber() の結果：指定された国で有効な登録電話番号である場合、これはtrueとなります。
         3. isValidNumberForRegion()の結果：電話番号に指定された国に関する適切な情報がすべて含まれている場合、これはtrueとなります。
            1. 例えば、国コードが「us」であるものの、電話番号に米国の州や準州に一致する市外局番が含まれない場合、対象地域で有効な電話番号ではないことを意味し、このフィールドはfalseとなります。

2. 検証結果フィールドのいずれかがfalseの場合
   1. 電話番号が無効であることをlibphonenumberが示しているため、Yext Contentはその電話番号を受け付けません。
   2. 電話番号が有効であり、libphonenumberのテストに誤りがあると思われる場合は、こちらからlibphonenumberのチケットを送信してください。
      1. 電話番号が無効であることを示すデモテストの情報と、電話番号が有効である必要がある理由を示す情報を必ず含めてください。
   3. libphonenumberで問題が解決されたら、Yextサポートまたはクライアントサクセスマネージャーにその旨をお知らせください。libphonenumberが行った変更を反映するには、当社のライブラリを更新する必要があります。
3. 検証結果フィールドがすべてtrueの場合
   1. 電話番号が有効であることをlibphonenumberが示しているにも関わらず、Yext Contentがその電話番号を受け付けていません。この場合、Yext Contentに問題がある可能性があります。
   2. 問題を解決するには、Yextサポートにお問い合わせください。