A partire dall'8 settembre 2025, ogni nuovo elemento pubblicitario dovrà dichiarare se pubblicherà o meno annunci politici dell'Unione Europea (UE). I caricamenti di API Display & Video 360 e SDF che non forniscono dichiarazioni non andranno a buon fine. Consulta la nostra pagina dei ritiri per ulteriori dettagli su come aggiornare l'integrazione per effettuare questa dichiarazione.
Elenca gli utenti accessibili all'utente corrente. Se due utenti hanno ruoli utente sullo stesso partner o inserzionista, possono accedere l'uno all'altro.
Questo metodo ha requisiti di autenticazione unici. Prima di utilizzare questo metodo, leggi i prerequisiti nella nostra Guida alla gestione degli utenti.
La funzionalità "Prova questo metodo" non funziona per questo metodo.
Dimensioni della pagina richiesta. Il valore deve essere compreso tra 1 e 200. Se non specificato, il valore predefinito è 100.
pageToken
string
Un token che identifica una pagina di risultati che il server deve restituire. In genere, questo è il valore di nextPageToken restituito dalla chiamata precedente al metodo users.list. Se non specificato, verrà restituita la prima pagina dei risultati.
orderBy
string
Campo in base al quale ordinare l'elenco. I valori accettabili sono:
displayName (valore predefinito)
L'ordinamento predefinito è crescente. Per specificare l'ordine decrescente per un campo, al nome del campo deve essere aggiunto il suffisso "desc". Ad esempio, displayName desc.
filter
string
Consente il filtraggio in base ai campi utente.
Sintassi supportata:
Le espressioni di filtro sono costituite da una o più limitazioni.
Le limitazioni possono essere combinate mediante l'operatore logico AND.
Una limitazione ha la forma di {field} {operator} {value}.
I campi displayName e email devono utilizzare l'operatore HAS (:).
Il campo lastLoginTime deve utilizzare l'operatore LESS THAN OR EQUAL TO (<=) o GREATER THAN OR EQUAL TO (>=).
Tutti gli altri campi devono utilizzare l'operatore EQUALS (=).
Campi supportati:
assignedUserRole.advertiserId
assignedUserRole.entityType: questo è il campo sintetico di AssignedUserRole utilizzato per il filtraggio. Identifica il tipo di entità a cui è assegnato il ruolo utente. I valori validi sono Partner e Advertiser.
assignedUserRole.parentPartnerId: Questo è un campo sintetico di AssignedUserRole utilizzato per il filtraggio. Identifica il partner principale dell'entità a cui è assegnato il ruolo utente.
assignedUserRole.partnerId
assignedUserRole.userRole
displayName
email
lastLoginTime (input in formato ISO 8601 o YYYY-MM-DDTHH:MM:SSZ)
Esempi:
L'utente con displayName contenente "foo": displayName:"foo"
L'utente con email contenente "bar": email:"bar"
Tutti gli utenti con ruoli utente standard: assignedUserRole.userRole="STANDARD"
Tutti gli utenti con ruoli utente per il partner 123: assignedUserRole.partnerId="123"
Tutti gli utenti con ruoli utente per l'inserzionista 123: assignedUserRole.advertiserId="123"
Tutti gli utenti con ruoli utente a livello di partner: entityType="PARTNER"
Tutti gli utenti con ruoli utente per il partner 123 e gli inserzionisti del partner 123: parentPartnerId="123"
Tutti gli utenti che hanno eseguito l'ultimo accesso il giorno 01/01/2023 alle ore 00:00:00 UTC o in una data successiva (formato ISO 8601): lastLoginTime>="2023-01-01T00:00:00Z"
La lunghezza di questo campo non deve superare i 500 caratteri.
Un token per recuperare la pagina successiva dei risultati. Passa questo valore nel campo pageToken nella chiamata successiva al metodo users.list per recuperare la pagina successiva dei risultati. Questo token non sarà presente se non ci sono altri risultati da restituire.
[[["Facile da capire","easyToUnderstand","thumb-up"],["Il problema è stato risolto","solvedMyProblem","thumb-up"],["Altra","otherUp","thumb-up"]],[["Mancano le informazioni di cui ho bisogno","missingTheInformationINeed","thumb-down"],["Troppo complicato/troppi passaggi","tooComplicatedTooManySteps","thumb-down"],["Obsoleti","outOfDate","thumb-down"],["Problema di traduzione","translationIssue","thumb-down"],["Problema relativo a esempi/codice","samplesCodeIssue","thumb-down"],["Altra","otherDown","thumb-down"]],["Ultimo aggiornamento 2025-09-09 UTC."],[[["\u003cp\u003eLists users accessible to the current user, including those with shared roles on partners or advertisers.\u003c/p\u003e\n"],["\u003cp\u003eSupports pagination and filtering by user properties like display name, email, assigned roles, and last login time.\u003c/p\u003e\n"],["\u003cp\u003eRequires authorization with the \u003ccode\u003ehttps://www.googleapis.com/auth/display-video-user-management\u003c/code\u003e scope.\u003c/p\u003e\n"],["\u003cp\u003eThe "Try this method" feature is unavailable for this specific method.\u003c/p\u003e\n"],["\u003cp\u003eSends an HTTP GET request to \u003ccode\u003ehttps://displayvideo.googleapis.com/v3/users\u003c/code\u003e.\u003c/p\u003e\n"]]],["This document details how to list accessible users via a `GET` request to `https://displayvideo.googleapis.com/v3/users`. It requires specific authorization scopes and authentication prerequisites. Query parameters allow for filtering by user fields (`displayName`, `email`, `lastLoginTime`, etc.), sorting (`orderBy`), and pagination (`pageSize`, `pageToken`). The request body must be empty. The successful response contains a list of user objects and a `nextPageToken` for further pagination, if needed.\n"],null,[]]
