Method: resources.calendars.list

Recupera un elenco di risorse del calendario per un account.

Richiesta HTTP

GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
customer

string

L'ID univoco dell'account Google Workspace del cliente. In qualità di amministratore dell'account, puoi anche utilizzare l'alias my_customer per rappresentare l'ID cliente del tuo account.

Parametri di query

Parametri
maxResults

integer

Il numero massimo di risultati da restituire.

orderBy

string

I campi in base ai quali ordinare i risultati in ordine crescente o decrescente. I campi supportati includono resourceId, resourceName, capacity, buildingId e floorName. Se non viene specificato alcun ordine, il valore predefinito è crescente. Deve avere il formato "campo [asc|desc], campo [asc|desc], ...". Ad esempio, buildingId, capacity desc restituirebbe i risultati ordinati prima per buildingId in ordine crescente e poi per capacity in ordine decrescente.

pageToken

string

Token per specificare la pagina successiva nell'elenco.

query

string

Stringa di query utilizzata per filtrare i risultati. Contiene una o più clausole di ricerca, ciascuna con un campo, un operatore e un valore. Un campo può essere uno qualsiasi dei campi supportati e gli operatori possono essere una qualsiasi delle operazioni supportate. Gli operatori includono "=" per la corrispondenza esatta, "!=" per la mancata corrispondenza e ":" per la corrispondenza del prefisso o la corrispondenza HAS, se applicabile. Per la corrispondenza del prefisso, il valore deve sempre essere seguito da un asterisco (*). Gli operatori logici NOT e AND sono supportati (in questo ordine di precedenza). I campi supportati includono generatedResourceName, name, buildingId, floorName, capacity, featureInstances.feature.name, resourceEmail, resourceCategory. Ad esempio buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

API pubblica: Resources.calendars

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON
{
  "kind": string,
  "etag": string,
  "items": [
    {
      object (CalendarResource)
    }
  ],
  "nextPageToken": string
}
Campi
kind

string

Identifica questo elemento come una raccolta di CalendarResources. Questo valore è sempre admin#directory#resources#calendars#calendarResourcesList.

etag

string

ETag della risorsa.

items[]

object (CalendarResource)

Le CalendarResources in questa pagina dei risultati.

nextPageToken

string

Il token di continuazione, utilizzato per scorrere grandi set di risultati. Fornisci questo valore in una richiesta successiva per restituire la pagina successiva dei risultati.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

  • https://apps-apis.google.com/a/feeds/calendar/resource/
  • https://www.googleapis.com/auth/admin.directory.resource.calendar
  • https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly

Per ulteriori informazioni, consulta la Guida all'autorizzazione.