Documentation Index

Fetch the complete documentation index at: https://guide.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

Application

Prev Next

Classic/VPC環境で利用できます。

NAVER API HUBのサポート環境を確認したら、NAVER API HUBの利用を開始するための準備が完了します。さて、次にまずやるべきことは、NAVER API HUBのご利用の申し込みを行って管理することです。NAVER API HUBのご利用の申し込みと利用に関する管理は、NAVERクラウドプラットフォームコンソールで行います。

参考

NAVER API HUBは APIで提供するサービスであるため、NAVERクラウドプラットフォームコンソールではご利用の申し込みや解約、利用管理のみ可能です。

このガイドで学習する内容をまとめると、次の通りです。

ご利用の申し込み

NAVER API HUBサービスのご利用を申し込む方法は、次の通りです。

参考

APIサービス利用規約に対する同意は、NAVERクラウドプラットフォームの AI·NAVER APIサービスを初回利用する時に行います。既に AI·NAVER APIの他のサービスを利用中の場合、本プロセスは省略されるので Application登録に移動します。

  1. NAVERクラウドプラットフォームコンソールにアクセスします。
  2. コンソール画面右上のリージョン&プラットフォームボタンをクリックします。
  3. 利用中のリージョンとプラットフォームを選択し、 [適用] ボタンをクリックします。
  4. コンソール画面左上の Menuをクリックします。
  5. Services > Application Services > NAVER API HUBメニューを順にクリックします。
  6. Subscriptionメニューをクリックします。
  7. [サービスご利用の申し込み] ボタンをクリックします。
  8. ポップアップ画面が表示されたら、サービス利用規約と個人情報の第3者提供に関するご案内をご確認の上、同意される場合は下部のチェックボックスをクリックします。
  9. [確認] ボタンをクリックします。
  10. 登録可能な Applicationリストを確認し、次の手続きを行います。
参考

Applicationを登録すると、Application 1つにつき固有の Client IDと Client Secret値が作成されます。Client IDと Client Secret値は API呼び出し時に HTTPヘッダ値に含まれて送信されます。API呼び出し方法についての詳細は、NAVERクラウドプラットフォーム APIガイドの NAVER連携 API呼び出しをご参照ください。

Application登録

APIサービス利用規約に同意した後に、Applicationを登録します。Applicationは NAVER API HUBの APIを利用するために必ず必要です。Applicationを登録すると Application 1つにつき固有の Client IDと Client Secret値が作成されますが、API呼び出し時に Client IDと Client Secret値を HTTPヘッダ値に含めて送信するためです。

参考

API呼び出し方法についての詳細は、NAVERクラウドプラットフォーム APIガイドの NAVER連携 API呼び出しをご参照ください。

Applicationを登録する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。

  2. Applicationメニューをクリックします。

  3. [Application登録] ボタンをクリックします。

  4. API選択画面で登録を希望する APIを選択した後、 [次へ] ボタンをクリックします。

    • 右上でカテゴリの選択と検索が可能です。
    • 各 APIカード内の [料金のご案内][開発ガイド] を確認できます。
    • 提供する APIは、次の通りです。
      カテゴリ API 説明 月間最大呼び出し件数
      NAVER検索 ニュース NAVERニュース検索結果の照会 775,000件
      ブログ NAVERブログ検索結果の照会
      地域 NAVER地域サービス会社·機関検索結果の照会
      知識 iN NAVER知識 iN検索結果の照会
      カフェ NAVERカフェ投稿検索結果の照会
      百科事典 NAVER百科事典検索結果の照会
      画像 NAVER画像検索結果の照会
      成人向け検索キーワードの判別 入力検索キーワードの成人向け検索キーワード有無の判別
      誤字変換 韓国語/英語キー誤入力検索キーワードの変換結果の照会
      ウェブドキュメント NAVERウェブドキュメント検索結果の照会
      Data Lab ショッピングインサイト ショッピング分野·キーワード別の検索クリック数推移の照会(デバイス·性別·年齢別細分化) 50,000件
      検索キーワードトレンド キーワードでまとめた検索キーワードの統合検索推移の照会 50,000件
  5. Application情報入力画面で選択した Application情報確認および Application名を入力します。

    • 選択した Application: 以前のステップで選択した API項目
    • Application名: Application名を入力
      • 最大20文字まで入力可能
      • アルファベット、数字、特殊文字(-)のみ入力可能
  6. [完了] ボタンをクリックします。

    • Applicationが登録されます。

Application情報確認

登録された Applicationリストは NAVERクラウドプラットフォームコンソールの Application Services > NAVER API HUB > Applicationメニューで確認できます。Applicationリストで Application情報を確認する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Application情報を確認します。
    • Application: Application登録時に設定したアプリの名前
    • Category: Application登録時に選択したサービス
    • API: Application登録時に選択したサービス
    • 当日使用量: API別のリアルタイム日別使用量(UTC+9基準)
    • 当月使用量: API別のリアルタイム月別使用量(UTC+9基準)
    • 登録日時: Applicationを登録した日付
    • 設定: API呼び出し利用限度や特定値(%)超過時の通知を設定
  4. [認証情報] ボタンをクリックします。
    naverapihub_application_app_01_ko
  5. 認証情報画面が表示されたら、認証情報を確認します。
    • Application Key
      • Application名: Applicationを区分する名前
      • Client ID(X-NCP-APIGW-API-KEY-ID): 認証に必要な IDでヘッダまたはクエリ文字列に「X-NCP-APIGW-API-KEY-ID」を入力 naverapihub-ico_01{height="" width=""} クリック時にコピー可能
      • Client Secret(X-NCP-APIGW-API-KEY): 認証に必要な SecretKeyパスワードでヘッダまたはクエリ文字列に「X-NCP-APIGW-API-KEY」を入力 naverapihub-ico_01{height="" width=""} クリック時に値をコピーでき、 [再発行] ボタンをクリックすると値を変更可能
  6. [確認] ボタンをクリックします。
注意

Client IDと Client Secretが外部に表示されないようにご注意ください。セキュリティ上の懸念がある場合、7.で認証情報を新しい値に再発行します。

Application変更

登録した Application情報を変更する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. 変更する Applicationの naverapihub_hambarger_button ボタンをクリックします。
  4. [Application変更] ボタンをクリックします。
  5. 必要な情報を変更した後、 [保存] ボタンをクリックします。
    • Application情報が変更されます。

Application削除

登録した Applicationを削除する方法は次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. 削除する Applicationの naverapihub_hambarger_button ボタンをクリックします。
  4. [Application削除] ボタンをクリックします。
  5. [Application削除] のポップアップで Application名を確認し、 [確認] ボタンをクリックします。
    • Applicationが削除されます。

利用管理

登録した Application別利用状況を確認し、課金管理のための様々なオプションを設定できます。

当日/当月の使用量確認

当日の使用量と当月の使用量を確認する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Applicationリストで使用量を確認する Applicationの当日使用量と当月使用量のリアルタイム使用状況を確認します。
    • UTC+9基準
    • 韓国時間を基準に00:00 AMに日別利用量が0に初期化されます
参考

実際当日/当月使用量は反映されるまで約1分かかります。

利用限度設定

高額なサービス利用料金が請求されることを防止するために日別、月別の利用限度を直接設定できます。利用限度を設定する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。

  2. Applicationメニューをクリックします。

  3. .Applicationリストで利用限度を変更する Applicationの [限度と通知] ボタンをクリックします。
    naverapihub_application_app_02_ko

  4. [限度設定] タブメニューで月別限度値と日別限度値を入力します。
    naverapihub_application_limit_01_ko

  5. [保存] ボタンをクリックします。

参考

利用限度を変更した履歴は限度と通知ポップアップの [限度更新履歴] タブメニューで確認できます。

しきい値通知設定

ユーザーが設定した日別/月別限度値の特定使用率を超過した場合、メールまたは SMSで通知を受信できます。
しきい値通知を設定する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Applicationリストで利用限度を変更する Applicationの [限度と通知] ボタンをクリックします。
  4. [限度設定] タブメニューで月別限度設定または日別限度設定項目のチェックボックスをクリックして選択します。
  5. 通知の基準となるしきい値(%)を選択します。
    naverapihub_application_limit_02_ko
    • 70%を選択した場合、70%、80%、90%、100%に通知
    • 90%を選択した場合、90%、100%に通知
  6. [保存] ボタンをクリックします。
  7. 通知対象設定を参照して、しきい値通知の設定を受信するアドレスを入力します。
参考

しきい値通知を設定した場合でも、通知対象者を設定しないと通知が受信されません。必ず通知対象者を設定します。

通知対象設定

ユーザーが設定した日別/月別限度値の特定使用率を超過した場合、通知を受ける受取人と受信方法を設定する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールで、Menu > Services > Application Services > NAVER API HUBメニューを順にクリックします。
  2. Applicationメニューをクリックします。
  3. Applicationリストで利用限度を変更する Applicationの [限度と通知] ボタンをクリックします。
  4. [通知対象設定] タブメニューをクリックします。
  5. 通知対象の担当者を選択して通知方法を選択し、 [追加] ボタンをクリックします。
    • 新しい担当者を追加するために Cloud Insight(Monitoring)に移動するには、 [通知対象管理] ボタンをクリック
  6. 通知対象者の設定が完了したら、 [保存] ボタンをクリックします。
参考

通知対象の設定では、登録された通知対象担当者のみ選択できます。新しい担当者を登録するタスクは、Cloud Insightの Notification Recipientメニューで実行できます。詳細は、Notification Recipient ご利用ガイドの対象者追加をご参照ください。

解約する

NAVER API HUBご利用の解約のためには作成した NAVER API HUBの Applicationをすべて削除する必要があります。Application削除後に NAVER API HUBのご利用を解約する方法は、次の通りです。

  1. NAVERクラウドプラットフォームコンソールにアクセスします。
  2. コンソール画面右上のリージョン&プラットフォームボタンをクリックします。
  3. 利用中のリージョンとプラットフォームを選択し、 [適用] ボタンをクリックします。
  4. コンソール画面左上の Menuをクリックします。
  5. Services > Application Services > NAVER API HUBメニューを順にクリックします。
  6. Subscriptionメニューをクリックします。
  7. [サービス利用中] ボタンをクリックし、サービスを解約するをクリックします。
  8. サービスご利用の解約ポップアップの内容を確認し、 [確認] ボタンをクリックします。
  9. サービスご利用の解約ポップアップの [確認] ボタンをクリックします。
    • 解約されます。