PutDocumentsRequest.Builder.AddTakenActionGenericDocuments 方法
定義
重要
部分資訊涉及發行前產品，在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊，不做任何明確或隱含的瑕疵擔保。
多載
| 名稱 | Description |
|---|---|
| AddTakenActionGenericDocuments(GenericDocument[]) |
在請求中新增一個或多個包含已執行動作指標的 GenericDocument 物件。 |
| AddTakenActionGenericDocuments(ICollection<GenericDocument>) |
在請求中新增包含已執行動作度量的 GenericDocument 物件集合。 |
AddTakenActionGenericDocuments(GenericDocument[])
在請求中新增一個或多個包含已執行動作指標的 GenericDocument 物件。
[Android.Runtime.Register("addTakenActionGenericDocuments", "([Landroid/app/appsearch/GenericDocument;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)]
public Android.App.AppSearch.PutDocumentsRequest.Builder AddTakenActionGenericDocuments(params Android.App.AppSearch.GenericDocument[] takenActionGenericDocuments);[<Android.Runtime.Register("addTakenActionGenericDocuments", "([Landroid/app/appsearch/GenericDocument;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)>]
member this.AddTakenActionGenericDocuments : Android.App.AppSearch.GenericDocument[] -> Android.App.AppSearch.PutDocumentsRequest.Builder參數
- takenActionGenericDocuments
- GenericDocument[]
一個或多個包含已執行動作度量欄位的 GenericDocument 物件。 這個值不可能為零值。
傳回
- 屬性
備註
在請求中新增一個或多個包含已執行動作指標的 GenericDocument 物件。 建議使用 Jetpack 函式庫中的已採取行動文件類別來建構已採取行動文件。 GenericDocument 的文件建立時間戳應該透過 GenericDocument.Builder.setCreationTimestampMillis 設定為實際動作的時間戳。 用戶端應依 GenericDocument.getCreationTimestampMillis 依時間順序，將搜尋與點擊動作一同報告。 例如，如果有兩個搜尋動作，第一個有 1 個點擊動作，第二個有 2 個點擊動作，客戶應該回報 [searchAction1， clickAction1， searchAction2， clickAction2， clickAction3]。 AppSearch 將收集不同類型的已執行動作與指標：搜尋行動類型：LONG，即行動類型的列舉值。 搜尋動作需要 1。 query：STRING，使用者輸入的搜尋輸入（無需運算子或重寫）。 fetchedResultCount： LONG，指此搜尋動作中從 AppSearch 取得的 SearchResult 文件數量。 點擊動作 actionType： LONG，即該動作類型的列舉值。 點擊動作需要 2 點。 query： STRING，使用者輸入的搜尋輸入（不含運算子或重寫），產生使用者所採取的 SearchResult。 referencedQualifiedId：STRING，使用者對 SearchResult 文件的合格 ID，使用者可對此採取行動。 合格 ID 是由套件、資料庫、命名空間及文件 ID 產生的字串。更多細節請參見 DocumentIdUtil.createQualifiedId（String， String， GenericDocument）。 resultRankInBlock：LONG，即 SearchResult 文件在使用者定義區塊中的排名。 客戶端可以自訂區塊定義，例如語料庫名稱、群組等。例如，客戶將區塊定義為語料庫，AppSearch 回傳 5 份文件，語料庫 = [“corpus1”， “corpus1”， “corpus2”， “corpus3”， “corpus2”]。 則該區塊的秩 = [1， 2， 1， 1， 2]。 如果客戶端沒有以多個區塊呈現結果，他們應該將此值設定為與 resultRankGlobal 相符。 resultRankGlobal：LONG，SearchResult 文件的全域排名。 全球排名反映 AppSearch 回傳的 SearchResult 文件順序。 例如，AppSearch 會回傳 2 頁，每頁有 10 份 SearchResult 文件。 接著，第一頁的全局排名會是 1 到 10，第二頁則是 11 到 20。 timeStayOnResultMillis：LONG，指使用者點擊搜尋結果文件後停留的時間（毫秒）。 使用此 API 報告的某些匿名化資訊可能會透過 statsd 上傳，並可能用以提升搜尋演算法的品質。 此類別中的大部分資訊已無法識別，例如時值及其在結果集中的位置。 您選擇提供的可識別資訊，如查詢字串，將透過 Federated Analytics 等技術進行匿名化，確保整個使用者族群中僅保留並可供研究的最常搜尋詞彙。 你也可以使用 addGenericDocuments（GenericDocument...）API 保留了加入並在裝置上使用的好處，同時不會觸發上述匿名統計上傳。
Android 參考資料。android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。
適用於
AddTakenActionGenericDocuments(ICollection<GenericDocument>)
在請求中新增包含已執行動作度量的 GenericDocument 物件集合。
[Android.Runtime.Register("addTakenActionGenericDocuments", "(Ljava/util/Collection;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)]
public Android.App.AppSearch.PutDocumentsRequest.Builder AddTakenActionGenericDocuments(System.Collections.Generic.ICollection<Android.App.AppSearch.GenericDocument> takenActionGenericDocuments);[<Android.Runtime.Register("addTakenActionGenericDocuments", "(Ljava/util/Collection;)Landroid/app/appsearch/PutDocumentsRequest$Builder;", "", ApiSince=35)>]
member this.AddTakenActionGenericDocuments : System.Collections.Generic.ICollection<Android.App.AppSearch.GenericDocument> -> Android.App.AppSearch.PutDocumentsRequest.Builder參數
- takenActionGenericDocuments
- ICollection<GenericDocument>
一組包含已執行動作度量欄位的 GenericDocument 物件集合。 這個值不可能為零值。
傳回
- 屬性
備註
在請求中新增包含已執行動作度量的 GenericDocument 物件集合。
Android 參考資料。android.app.appsearch.PutDocumentsRequest.Builder.addTakenActionGenericDocuments
本頁部分內容為基於 Open Source Project 所創建與分享的作品，並依授權條款所描述的使用進行修改。