Method: contactGroups.get

指定聯絡人群組的資源名稱,取得已驗證使用者擁有的特定聯絡人群組。

HTTP 要求

GET https://people.googleapis.com/v1/{resourceName=contactGroups/*}

這個網址使用 gRPC 轉碼語法。

路徑參數

參數
resourceName

string

必要欄位。要取得的聯絡人群組的資源名稱。

查詢參數

參數
maxMembers

integer

選用設定。指定要傳回的成員人數上限。如未設定,預設值為 0,且會傳回零個成員。

groupFields

string (FieldMask format)

選用設定。欄位遮罩,用於限制傳回群組中的欄位。如未設定或設為空白,預設值為 metadatagroupTypememberCountname。有效欄位如下:

  • clientData
  • groupType
  • memberCount
  • 中繼資料
  • 名稱

要求主體

要求主體必須為空白。

回應主體

如果成功,回應主體會包含 ContactGroup 的執行例項。

授權範圍

需要下列其中一種 OAuth 範圍:

  • https://www.googleapis.com/auth/contacts
  • https://www.googleapis.com/auth/contacts.readonly

詳情請參閱授權指南