- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- Essayer
Liste les ordres d'insertion d'un annonceur.
L'ordre est défini par le paramètre orderBy
. Si aucune valeur filter
de entityStatus
n'est spécifiée, les ordres d'insertion avec ENTITY_STATUS_ARCHIVED
ne seront pas inclus dans les résultats.
Requête HTTP
GET https://displayvideo.googleapis.com/v3/advertisers/{advertiserId}/insertionOrders
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
advertiserId |
Obligatoire. ID de l'annonceur pour lequel répertorier les ordres d'insertion. |
Paramètres de requête
Paramètres | |
---|---|
pageSize |
Taille de la page demandée. La valeur doit être comprise entre |
pageToken |
Jeton identifiant une page de résultats que le serveur doit renvoyer. En général, il s'agit de la valeur de |
orderBy |
Champ selon lequel la liste doit être triée. Les valeurs acceptées sont les suivantes :
Par défaut, l'ordre de tri est croissant. Pour indiquer l'ordre décroissant d'un champ, ajoutez un suffixe "desc". doit être ajouté au nom du champ. Exemple : |
filter |
Permet le filtrage par champs d'ordre d'insertion. Syntaxe compatible:
Champs acceptés:
Exemples :
La longueur de ce champ ne doit pas dépasser 500 caractères. Pour en savoir plus, consultez notre guide sur le filtrage des requêtes |
Corps de la requête
Le corps de la requête doit être vide.
Corps de la réponse
Si la requête aboutit, le corps de la réponse contient des données présentant la structure suivante :
Représentation JSON |
---|
{
"insertionOrders": [
{
object ( |
Champs | |
---|---|
insertionOrders[] |
Liste des ordres d'insertion. Cette liste sera absente si elle est vide. |
nextPageToken |
Jeton permettant de récupérer la page de résultats suivante. Transmettez cette valeur dans le champ |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/display-video
Pour en savoir plus, consultez la Présentation d'OAuth 2.0.