直方圖 (v3)

Cloud Talent Solution 可讓您使用直方圖來呈現與特定搜尋相關聯的職缺數量。直方圖搜尋會傳回符合特定查詢的所有職缺計數，並依要求的 searchType 加以細分。 舉例來說，直方圖搜尋可以傳回 Mountain View, CA 裡各種聘僱類型 (全職、兼職等) 的職缺數量。如要定義直方圖的維度和參數，請按照本指南中的說明操作。

一般來說，直方圖會與搜尋呼叫平行執行，使用相同的 JobQuery 和 requestMetadata。

要求

您可以透過底層的 search API 取得直方圖。方法是在 search API 上設定 histogramFacets，並定義要求的篩選器。請注意，直方圖會套用搜尋查詢中定義的所有篩選器。以下範例說明擷取直方圖的機制。

必填欄位

• searchTypes 是要傳回計數的類別清單。比方說，指定 EMPLOYMENT_TYPE 即可傳回聘僱類型 (如全職或兼職) 的計數。如需詳細的列舉清單，請參閱 SearchType。

選填欄位

• jobQuery 是要在這項搜尋中執行的工作查詢。詳情請參閱搜尋篩選器。此範例將不套用任何查詢。

• requestMetadata 包含啟動搜尋之使用者的相關資訊。詳情請參閱職缺搜尋頁面的 RequestMetadata 區段。

• enableBroadening 可放寬搜尋要求的地點和職缺類別限制，以傳回更多結果。舉例來說，如果要求指定某地點半徑 20 英里內的職缺，將此標記設為 true 即可傳回該半徑以外的職缺。以下範例不包括放寬限制後的結果。

範例

以下範例會傳回跨 COMPANY_ID 和 customAttribute someFieldName1 的職缺計數清單：

Java

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

/** 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 用戶端程式庫。

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)

Go

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

// histogramSearch searches for jobs with histogram facets.
func histogramSearch(w io.Writer, projectID, companyName string) (*talent.SearchJobsResponse, error) {
	ctx := context.Background()

	client, err := google.DefaultClient(ctx, talent.CloudPlatformScope)
	if err != nil {
		return nil, fmt.Errorf("google.DefaultClient: %w", err)
	}
	// Create the jobs service client.
	service, err := talent.New(client)
	if err != nil {
		return nil, fmt.Errorf("talent.New: %w", err)
	}

	parent := "projects/" + projectID
	req := &talent.SearchJobsRequest{
		// Make sure to set the RequestMetadata the same as the associated
		// search request.
		RequestMetadata: &talent.RequestMetadata{
			// Make sure to hash your userID.
			UserId: "HashedUsrId",
			// Make sure to hash the sessionID.
			SessionId: "HashedSessionId",
			// Domain of the website where the search is conducted.
			Domain: "www.googlesample.com",
		},
		HistogramFacets: &talent.HistogramFacets{
			SimpleHistogramFacets: []string{"COMPANY_ID"},
			CustomAttributeHistogramFacets: []*talent.CustomAttributeHistogramRequest{
				{
					Key:                  "someFieldString",
					StringValueHistogram: true,
				},
			},
		},
		// Set the search mode to a regular search.
		SearchMode:               "JOB_SEARCH",
		RequirePreciseResultSize: true,
	}
	if companyName != "" {
		req.JobQuery = &talent.JobQuery{
			CompanyNames: []string{companyName},
		}
	}

	resp, err := service.Projects.Jobs.Search(parent, req).Do()
	if err != nil {
		return nil, fmt.Errorf("failed to search for jobs with Historgram Facets: %w", err)
	}

	fmt.Fprintln(w, "Jobs:")
	for _, j := range resp.MatchingJobs {
		fmt.Fprintf(w, "\t%q\n", j.Job.Name)
	}

	return resp, nil
}

關聯性門檻

直方圖要求不會使用關聯性門檻。如要確保直方圖搜尋和相同的職缺搜尋會得出一致的計數，職缺搜尋中的 disableKeywordMatch 必須為 false。