Pour chaque nouvel élément de campagne, vous devez indiquer s'il diffusera ou non des annonces à caractère politique dans l'Union européenne (UE). Les importations de fichiers SDF et de l'API Display & Video 360 qui ne fournissent pas de déclarations échoueront. Pour en savoir plus, consultez notre
page sur les abandons.
Method: advertisers.negativeKeywordLists.negativeKeywords.replace
Restez organisé à l'aide des collections
Enregistrez et classez les contenus selon vos préférences.
Requête HTTP
POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
| Paramètres |
advertiserId |
string (int64 format)
Obligatoire. ID de l'annonceur DV360 auquel appartient la liste de mots clés à exclure parente.
|
negativeKeywordListId |
string (int64 format)
Obligatoire. ID de la liste de mots clés à exclure parente à laquelle les mots clés à exclure appartiennent.
|
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
| Représentation JSON |
{
"newNegativeKeywords": [
{
object (NegativeKeyword)
}
]
} |
| Champs |
newNegativeKeywords[] |
object (NegativeKeyword)
Mots clés à exclure qui remplaceront les mots clés existants de la liste de mots clés à exclure, spécifiés sous forme de liste NegativeKeywords.
|
Corps de la réponse
Message de réponse pour NegativeKeywordService.ReplaceNegativeKeywords.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
| Représentation JSON |
{
"negativeKeywords": [
{
object (NegativeKeyword)
}
]
} |
| Champs |
negativeKeywords[] |
object (NegativeKeyword)
La liste complète des mots clés à exclure est désormais présente dans la liste de mots clés à exclure.
|
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 OAuth 2.0 Overview.
Sauf indication contraire, le contenu de cette page est régi par une licence Creative Commons Attribution 4.0, et les échantillons de code sont régis par une licence Apache 2.0. Pour en savoir plus, consultez les Règles du site Google Developers. Java est une marque déposée d'Oracle et/ou de ses sociétés affiliées.
Dernière mise à jour le 2025/07/25 (UTC).
[null,null,["Dernière mise à jour le 2025/07/25 (UTC)."],[],["The Display & Video 360 API v4 allows replacing all negative keywords in a list using a POST request to a specific URL. This action requires the `advertiserId` and `negativeKeywordListId` as path parameters. The request body should include a JSON array of `newNegativeKeywords`, which will replace the existing ones. Upon successful execution, the response body returns a JSON array containing the complete, updated list of `negativeKeywords`. Authorization requires the `https://www.googleapis.com/auth/display-video` OAuth scope.\n"],null,["# Method: advertisers.negativeKeywordLists.negativeKeywords.replace\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n - [JSON representation](#body.request_body.SCHEMA_REPRESENTATION)\n- [Response body](#body.response_body)\n - [JSON representation](#body.ReplaceNegativeKeywordsResponse.SCHEMA_REPRESENTATION)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nReplaces all negative keywords in a single negative keyword list.\n\nThe operation will replace the keywords in a negative keyword list with keywords provided in [ReplaceNegativeKeywordsRequest.new_negative_keywords](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords/replace#body.request_body.FIELDS.new_negative_keywords).\n\n### HTTP request\n\n`POST https://displayvideo.googleapis.com/v4/advertisers/{advertiserId}/negativeKeywordLists/{negativeKeywordListId}/negativeKeywords:replace`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `advertiserId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the DV360 advertiser to which the parent negative keyword list belongs. |\n| `negativeKeywordListId` | `string (`[int64](https://developers.google.com/discovery/v1/type-format)` format)` Required. The ID of the parent negative keyword list to which the negative keywords belong. |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"newNegativeKeywords\": [ { object (/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword) } ] } ``` |\n\n| Fields ||\n|-------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `newNegativeKeywords[]` | `object (`[NegativeKeyword](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword)`)` The negative keywords that will replace the existing keywords in the negative keyword list, specified as a list of [NegativeKeywords](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword). |\n\n### Response body\n\nResponse message for NegativeKeywordService.ReplaceNegativeKeywords.\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"negativeKeywords\": [ { object (/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword) } ] } ``` |\n\n| Fields ||\n|----------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `negativeKeywords[]` | `object (`[NegativeKeyword](/display-video/api/reference/rest/v4/advertisers.negativeKeywordLists.negativeKeywords#NegativeKeyword)`)` The full list of negative keywords now present in the negative keyword list. |\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/display-video`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]
