分類內容

內容分類會分析文件內容並傳回符合文件文字內容的類別清單。如要將文件內容分類，請呼叫 classifyText 方法。

如需 classifyText 方法傳回的內容類別完整清單，請參閱這裡。

您可以設定選用的 classificationModelOptions 欄位，選擇要用於 classifyText 方法的模型：

本節說明如何將文件中的內容分類。 你必須為每份文件分別提交要求。

分類內容

以下示範如何分類以字串提供的內容：

通訊協定

POST 要求，並提供適當的要求主體，如同下列範例所示。documents:classifyText

範例中使用的 gcloud auth application-default print-access-token 指令，可取得透過 Google Cloud Platform gcloud CLI 建立的專案服務帳戶存取權杖。如需安裝 gcloud CLI、使用服務帳戶建立專案的操作說明，請參閱「快速入門」。

curl -X POST \
     -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
     -H "Content-Type: application/json; charset=utf-8" \
     --data "{
  'document':{
    'type':'PLAIN_TEXT',
    'content':'Google, headquartered in Mountain View, unveiled the new Android
    phone at the Consumer Electronic Show.  Sundar Pichai said in his keynote
    that users love their new Android phones.'
  },
  'classificationModelOptions': {
    'v2Model': {
      'contentCategoriesVersion': 'V2',
    }
  }
}" "https://language.googleapis.com/v1/documents:classifyText"

Go

如要瞭解如何安裝及使用 Natural Language 的用戶端程式庫，請參閱「Natural Language 用戶端程式庫」。詳情請參閱 Natural Language Go API 參考文件。

如要向 Natural Language 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。


func classifyText(ctx context.Context, client *language.Client, text string) (*languagepb.ClassifyTextResponse, error) {
	return client.ClassifyText(ctx, &languagepb.ClassifyTextRequest{
		Document: &languagepb.Document{
			Source: &languagepb.Document_Content{
				Content: text,
			},
			Type: languagepb.Document_PLAIN_TEXT,
		},
		ClassificationModelOptions: &languagepb.ClassificationModelOptions{
			ModelType: &languagepb.ClassificationModelOptions_V2Model_{
				V2Model: &languagepb.ClassificationModelOptions_V2Model{
					ContentCategoriesVersion: languagepb.ClassificationModelOptions_V2Model_V2,
				},
			},
		},
	})
}

Java

如要瞭解如何安裝及使用 Natural Language 的用戶端程式庫，請參閱「Natural Language 用戶端程式庫」。詳情請參閱 Natural Language Java API 參考文件。

如要向 Natural Language 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

// Instantiate the Language client com.google.cloud.language.v2.LanguageServiceClient
try (LanguageServiceClient language = LanguageServiceClient.create()) {
  // Set content to the text string
  Document doc = Document.newBuilder().setContent(text).setType(Type.PLAIN_TEXT).build();
  ClassifyTextRequest request = ClassifyTextRequest.newBuilder().setDocument(doc).build();
  // Detect categories in the given text
  ClassifyTextResponse response = language.classifyText(request);

  for (ClassificationCategory category : response.getCategoriesList()) {
    System.out.printf(
        "Category name : %s, Confidence : %.3f\n",
        category.getName(), category.getConfidence());
  }
}

Node.js

如要瞭解如何安裝及使用 Natural Language 的用戶端程式庫，請參閱「Natural Language 用戶端程式庫」。詳情請參閱 Natural Language Node.js API 參考文件。

如要向 Natural Language 進行驗證，請設定應用程式預設憑證。詳情請參閱「為本機開發環境設定驗證機制」。

// Imports the Google Cloud client library
const language = require('@google-cloud/language');

// Creates a client
const client