直方圖 (v3)

您可以使用直方圖來呈現與指定搜尋相關聯的職缺數量。如果搜尋要求設定了直方圖分面集 (Facets Set)，則會傳回搜尋結果以及符合特定查詢條件的所有職缺計數，並依要求的 searchType 進行細分。

比方說，直方圖搜尋可以傳回客戶職缺集裡各種聘僱類型 (全職、兼職等) 的職缺數量。

Cloud Talent Solution Beta 版 (v3p1beta1) 可讓您以較鬆散的結構、更有彈性且更直覺化的方式定義直方圖，直方圖的表示法則不會改變。

優點

新的直方圖查詢結構能讓開發人員更直覺地定義直方圖要求，同時讓您更清楚地瞭解值區、範圍等定義。

使用方法

搜尋查詢的新直方圖部分會取代定義直方圖的舊結構化欄位。

程式碼範例

以下程式碼範例會傳回直方圖結果。

histogramQuery 欄位目前為單一字串欄位，這是定義直方圖的運算式。如要進一步瞭解直方圖查詢可用的函式，請參閱 HistogramQuery。

Java

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。

Java

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


/** Histogram search */
public static void histogramSearch(String companyName) throws IOException, InterruptedException {
  // Make sure to set the requestMetadata the same as the associated search request
  RequestMetadata requestMetadata =
      new RequestMetadata()
          // Make sure to hash your userID
          .setUserId("HashedUserId")
          // Make sure to hash the sessionID
          .setSessionId("HashedSessionID")
          // Domain of the website where the search is conducted
          .setDomain("www.google.com");

  HistogramFacets histogramFacets =
      new HistogramFacets()
          .setSimpleHistogramFacets(Arrays.asList("COMPANY_ID"))
          .setCustomAttributeHistogramFacets(
              Arrays.asList(
                  new CustomAttributeHistogramRequest()
                      .setKey("someFieldName1")
                      .setStringValueHistogram(true)));

  // conducted.
  SearchJobsRequest searchJobsRequest =
      new SearchJobsRequest()
          .setRequestMetadata(requestMetadata)
          .setSearchMode("JOB_SEARCH")
          .setHistogramFacets(histogramFacets);
  if (companyName != null) {
    searchJobsRequest.setJobQuery(new JobQuery().setCompanyNames(Arrays.asList(companyName)));
  }

  SearchJobsResponse searchJobsResponse =
      talentSolutionClient
          .projects()
          .jobs()
          .search(DEFAULT_PROJECT_ID, searchJobsRequest)
          .execute();
  Thread.sleep(1000);

  System.out.printf("Histogram search results: %s\n", searchJobsResponse);
}

Python

如要進一步瞭解如何安裝及建立 Cloud Talent Solution 用戶端，請參閱 Cloud Talent Solution 用戶端程式庫。

Python

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

def histogram_search(client_service, company_name):
    request_metadata = {
        "user_id": "HashedUserId",
        "session_id": "HashedSessionId",
        "domain": "www.google.com",
    }
    custom_attribute_histogram_facet = {
        "key": "someFieldName1",
        "string_value_histogram": True,
    }
    histogram_facets = {
        "simple_histogram_facets": ["COMPANY_ID"],
        "custom_attribute_histogram_facets": [custom_attribute_histogram_facet],
    }
    request = {
        "search_mode": "JOB_SEARCH",
        "request_metadata": request_metadata,
        "histogram_facets": histogram_facets,
    }
    if company_name is not None:
        request.update({"job_query": {"company_names": [company_name]}})
    response = (
        client_service.projects().jobs().search(parent=parent, body=request).execute()
    )
    print(response)