- Requête HTTP
- Paramètres de chemin d'accès
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- BasicInsightsAudience
- AudienceInsightsTopic
- Essayer
Crée un rapport enregistré qui peut être consulté dans l'outil Insights Finder.
Liste des erreurs générées: AuthenticationError AuthorizationError FieldError HeaderError InternalError QuotaError RangeError RequestError
Requête HTTP
POST https://googleads.googleapis.com/v16/customers/{customerId}:generateInsightsFinderReport
L'URL utilise la syntaxe de transcodage gRPC.
Paramètres de chemin d'accès
Paramètres | |
---|---|
customerId |
Obligatoire. ID du client. |
Corps de la requête
Le corps de la requête contient des données présentant la structure suivante :
Représentation JSON |
---|
{ "baselineAudience": { object ( |
Champs | |
---|---|
baselineAudience |
Obligatoire. Audience de référence pour ce rapport, généralement toutes les personnes d'une région. |
specificAudience |
Obligatoire. Audience spécifique qui intéresse ce rapport. Les insights du rapport seront basés sur des attributs plus répandus dans cette audience que dans l'audience de référence du rapport. |
customerInsightsGroup |
Nom du client pour lequel la planification est effectuée. Il s'agit d'une valeur définie par l'utilisateur. |
Corps de la réponse
Message de réponse pour AudienceInsightsService.GenerateInsightsFinderReport
, contenant l'URL partageable pour le rapport.
Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :
Représentation JSON |
---|
{ "savedReportUrl": string } |
Champs | |
---|---|
savedReportUrl |
URL HTTPS fournissant un lien profond dans l'interface utilisateur d'Insights Finder avec les entrées du rapport renseignées en fonction de la requête. |
Champs d'application des autorisations
Requiert le niveau d'accès OAuth suivant :
https://www.googleapis.com/auth/adwords
Pour en savoir plus, consultez la présentation d'OAuth 2.0.
BasicInsightsAudience
Description d'une audience utilisée pour demander des insights.
Représentation JSON |
---|
{ "countryLocation": [ { object ( |
Champs | |
---|---|
countryLocation[] |
Obligatoire. Pays de cette audience. |
subCountryLocations[] |
Attributs d'emplacement géographique infranational. S'il est présent, chacun de ces éléments doit être situé dans l'un des pays de ce type d'audience. |
gender |
Genre de l'audience. Si ce champ n'est pas inclus, l'audience n'est pas limitée par genre. |
ageRanges[] |
Tranches d'âge de l'audience. Si ce champ n'est pas renseigné, l'audience représente toutes les personnes de plus de 18 ans qui correspondent aux autres attributs. |
userInterests[] |
Centres d'intérêt des utilisateurs définissant cette audience. Les audiences d'affinité et sur le marché sont acceptées. |
topics[] |
Thèmes, représentés par des entités Knowledge Graph et/ou des catégories de produits et services, qui intéressent cette audience. |
AudienceInsightsTopic
Entité ou catégorie représentant un sujet qui définit une audience.
Représentation JSON |
---|
{ // Union field |
Champs | |
---|---|
Champ d'union topic . Attribut d'entité ou de catégorie. topic ne peut être qu'un des éléments suivants : |
|
entity |
Une entité Knowledge Graph |
category |
Une catégorie "Produits et services" |