Method: customers.generateInsightsFinderReport

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/v14/customers/{customerId}:generateInsightsFinderReport

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
customerId

string

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 (BasicInsightsAudience)
  },
  "specificAudience": {
    object (BasicInsightsAudience)
  },
  "customerInsightsGroup": string
}
Champs
baselineAudience

object (BasicInsightsAudience)

Obligatoire. Audience de référence pour ce rapport, généralement tous les utilisateurs d'une région.
specificAudience

object (BasicInsightsAudience)

Obligatoire. Audience spécifique qui intéresse ce rapport. Les insights du rapport seront basés sur des attributs plus fréquents dans cette audience que dans l'audience de référence du rapport.
customerInsightsGroup

string

Nom du client pour lequel effectuer la planification. Cette valeur est définie par l'utilisateur.

Corps de la réponse

Message de réponse pour AudienceInsightsService.GenerateInsightsFinderReport, contenant l'URL partageable du 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

string

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 (LocationInfo)
    }
  ],
  "subCountryLocations": [
    {
      object (LocationInfo)
    }
  ],
  "gender": {
    object (GenderInfo)
  },
  "ageRanges": [
    {
      object (AgeRangeInfo)
    }
  ],
  "userInterests": [
    {
      object (UserInterestInfo)
    }
  ],
  "topics": [
    {
      object (AudienceInsightsTopic)
    }
  ]
}
Champs
countryLocation[]

object (LocationInfo)

Obligatoire. Pays de cette audience.
subCountryLocations[]

object (LocationInfo)

Attributs d'emplacement géographique au sein d'un autre pays. S'il est présent, chacun d'entre eux doit être inclus dans l'un des pays de ce type d'audience.
gender

object (GenderInfo)

Genre de l'audience Si aucune valeur n'est spécifiée, l'audience n'est pas limitée en fonction du genre.
ageRanges[]

object (AgeRangeInfo)

Tranches d'âge de l'audience Si aucune valeur n'est spécifiée, l'audience représente toutes les personnes de plus de 18 ans qui correspondent aux autres attributs.
userInterests[]

object (UserInterestInfo)

Centres d'intérêt de l'utilisateur définissant cette audience. Les audiences d'affinité et sur le marché sont acceptées.
topics[]

object (AudienceInsightsTopic)

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 topic can be only one of the following:
  "entity": {
    object (AudienceInsightsEntity)
  },
  "category": {
    object (AudienceInsightsCategory)
  }
  // End of list of possible types for union field topic.
}
Champs
Champ d'union topic. Attribut d'entité ou de catégorie. topic ne peut être qu'un des éléments suivants :
entity

object (AudienceInsightsEntity)

Une entité Knowledge Graph
category

object (AudienceInsightsCategory)

Une catégorie "Produits et services"