開始使用 Perspective API
程式碼研究室簡介
subject上次更新時間：3月 10, 2022
2. 課程簡介
首先，您需要 Google Cloud 專案來驗證 API 要求。
- 在 Google Cloud Console 中使用現有專案。
- 如有需要，請按照下列步驟建立新專案：
- 登入 Google 帳戶。
- 開啟 Cloud Console。
- 按一下 [Create Project] 或開啟 [Select a Project] 選單，然後按一下對話方塊中的 [New Project]。
- 為專案命名，然後按一下 [Create]。
現在該專案會顯示在下拉式選單中。
要求 API 存取權
- 如要申請 API 存取權，請填寫這份表單。
你應該會在一小時內收到一封電子郵件，確認你可以在 Google Cloud 中查看及啟用這個 API。
3. 啟用 API
- 在 Cloud Console 中，前往「Perspective API 總覽」頁面，然後按一下 [啟用]。
4. 產生 API 金鑰
- 在導覽選單中，按一下 [APIs & Services > Credentials > Create credentials > API Key]。
您的 API 金鑰應該在幾分鐘內就能完成，但最多也可能需要一個小時。在此之前，您可能會收到錯誤訊息。
- 複製 API 金鑰。
5. 範例要求
您可以使用 Google API 用戶端程式庫產生 API 用戶端程式庫。以下範例說明如何使用一些常用語言來設定 API 程式庫。
- 發出
AnalyzeComment要求。 - 執行其中一種 API 呼叫範例，直接從 Perspective API 取得分數。
AnalyzeComment 方法會發出 API 要求來分析 requestedAttributes 的 comment.text 欄位 (這裡是指 TOXICITY 模型)。
- 將 API 金鑰貼到
API_KEY欄位中。
如有需要，您可以使用 doNotStore 標記，確保所有傳回的註解都會在分數傳回後自動刪除。
- 請參閱 API 參考說明文件，進一步瞭解所有要求和回應欄位，以及
requestedAttributes的可用值。
您還可以使用實驗屬性，例如 OBSCENE、ATTACK_ON_COMMENTER 和 SPAM。
Python
這個範例要求和回應使用 Python 版本的 Google API 用戶端程式庫。
- 安裝 Python 用戶端程式庫。
- 執行下列指令：
您應該會看到如下輸出結果：
親切的問候語有低惡意指數。
Node.js
這個範例要求和回應使用的是 Node.js 版本的 Google API 用戶端程式庫。
- 安裝 Node.js 用戶端程式庫或安裝 npm 套件
googleapis。 - 執行下列指令：
您應該會看到如下輸出結果：
cURL
此要求範例與回應使用 cURL 指令。這個指令適用於大多數的 MacOS 和 Linux 使用者。您可能需要安裝 cURL 才能執行此指令。
- 然後將
YOUR_KEY_HERE替換成您的 API 金鑰。
在這個回應中，attributeScores.TOXICITY.summaryScore.value 欄位會給予評論模型的惡意分數。評論為 0.9 分，滿分 1.0 分。
6. 恭喜
您已順利執行 Perspective API！
瞭解詳情
- Perspective API 網站提供有關 API 的詳細資訊，包括個案研究。
- Perspective API 開發人員網站提供了屬性、語言和方法的詳細資訊。如果您想快速開始操作，請參閱方法頁面，瞭解如何使用
AnalyzeComment和SuggestCommentScore方法。