本文件說明從 Cloud Talent Solution v2beta1 遷移至 v2 的步驟和注意事項。
程序
建立、讀取、更新、刪除及搜尋職缺等一般程序大致不變。
職缺物件的變更
- 重新命名了職缺物件中的幾個欄位。如需完整的變更清單，請參閱 V2 版的職缺物件。
- 新增了「Telecommute」類型，可指定遠距工作。
- 從 V2 移除了 V2Beta1 中標為淘汰的欄位。
- 新增了「CompensationInfo」欄位，以取代既有的薪酬欄位。
- 「Geolocations」欄位已重新命名為「JobLocation」欄位。
工作索引方法的變更
工作建立
- 移除了「disable_fast_process」欄位。建立呼叫現已預設為非同步。
- 新增了「disable_street_address_resolution」欄位。設定此欄位後，服務將不會嘗試推論職缺的實際街道地址。這主要是提供給不想要指出實際雇主是誰的人力仲介機構使用。
職缺更新
- 「更新」服務端點已重新命名為「修補」。
- 移除了「disable_fast_process」欄位。建立呼叫現已預設為非同步。
- 新增了「disable_street_address_resolution」欄位。設定此欄位後，服務將不會嘗試推論職缺的實際街道地址。這主要是提供給不想要指出實際雇主是誰的人力仲介機構使用。
職缺完成
- 自動完成方法「Complete(CompletionQuery)」已重新命名為「CompleteQuery(CompletionQuery)」。
- 此函數的回應也已重新命名為「CompleteQueryResponse」。
搜尋方法的變更
- 移除了 SearchFeaturedJobs 和 searchJobsForAlert 方法。改為使用一種搜尋方法，透過指定搜尋「Mode」欄位來產生相同的行為。
- 「ListCities」方法已重新命名為「ListCompanycities」。另外，「ListCitiesRequest」參數已重新命名為「ListCompanyCitiesRequest」；回應已從「ListCitiesResponse」變更為「ListCompanyCitiesResponse」。
- 已重新命名搜尋方法中的幾個欄位。如需完整的變更清單，請參閱 V2 版的搜尋方法。
- 將「MatchingJob」物件新增至代管作業和相關搜尋中繼資料，如 jobSummary 和程式碼片段。
- 透過「Mode」欄位指定搜尋類型 (一般、精選或搜尋職缺快訊案例)。
- 「sort_by」欄位已重新命名為「order_by」。
- 「histogram_facets」現已做為 ResponseMetaData 物件的一部分傳回。
列表方法的變更
- 已重新命名列表方法中的幾個欄位。如需完整的變更清單，請參閱 V2 版的列表方法。
- 已重新命名要求和回應物件。
- 「ListCities」方法已重新命名為「ListCompanyCities」。如需新的函式簽章，請參閱 ListCompanyCities。
- 「ListJobs」方法已重新命名為「ListCompanyJobs」。如需新的函式簽章，請參閱 ListCompanyJobs。
- 「ListJobCategories」方法已重新命名為「ListCategories」。如需新的函式簽章，請參閱 ListCompanyCities。
直方圖的變更
- 變更了直方圖要求的函式簽章。詳情請參閱 V2 版的直方圖。
ENUMERATION 字串的變更
- 「JobCategory」ENUM 字串已變更為「Category」。
- LocationType 類別對不同欄位類型的名稱進行了若干變更，例如「ADMIN1」已重新命名為「ADMINISTRATIVE_AREA」。如需更新後的 nomenclature，請參閱 v2 版的 LocationType 結構定義。
- 引進了新的列舉字串「Mode」，以指定搜尋要求的模式。因此，一般搜尋、精選職缺搜尋及職缺快訊案例搜尋現已整合為一種搜尋方法。
- 「PostingRegion」列舉字串已重新命名為「Region」。
- 新增了「Telecommute」列舉字串，可指定職缺的遠距工作屬性。
- TimeRange 列舉字串已重新命名為「DateRange」。如需欄位的詳細說明，請參閱 DateRange 列舉字串。
- 新增了可指定地理位置類型的列舉字串。詳情請參閱 Geolocation.LocationType。
Jobs Analytic Framework 訊息的變更 (透過 Pub/Sub)
- 已重新命名 ClientEvent 物件中的幾個欄位。如需完整的變更清單，請參閱 V2 版的 ClientEvent 物件。
- 新增了「SENT_CV」事件類型。
- 移除了 event_details 欄位和 UserId 欄位。
- Related_job_ids 欄位已重新命名為 related_job_names。但此欄位仍只接受搜尋傳回的 jobId 的值。
- 移除了版本欄位。