Method: locations.searchkeywords.impressions.monthly.list

Affiche les mots clés utilisés pour trouver un établissement dans la recherche ou sur Maps. Chaque mot clé pour le Réseau de Recherche est accompagné d'impressions cumulées mensuellement.

Exemple de requête: GET https://businessprofileperformance.googleapis.com/v1/locations/12345/searchkeywords/impressions/monthly?monthlyRange.start_month.year=2022&monthlyRange.start_month.month=1&monthlyRange.end_month.year=2022&monthlyRange.end_month.month=3

Requête HTTP

GET https://businessprofileperformance.googleapis.com/v1/{parent=locations/*}/searchkeywords/impressions/monthly

L'URL utilise la syntaxe de transcodage gRPC.

Paramètres de chemin d'accès

Paramètres
parent

string

Obligatoire. Emplacement pour lequel la série temporelle doit être extraite. Format: locations/{locationId}, où locationId est un ID de fiche non obscurci.

Paramètres de requête

Paramètres
monthlyRange

object (MonthlyRange)

Obligatoire. Période en mois pendant laquelle les impressions des mots clés pour le Réseau de Recherche sont agrégées.
pageSize

integer

Facultatif. Nombre de résultats demandés. La taille de page par défaut est 100. La taille de page peut être définie sur 100 au maximum.
pageToken

string (bytes format)

Facultatif. Jeton indiquant le prochain résultat paginé à renvoyer.

Chaîne encodée en base64.

Corps de la requête

Le corps de la requête doit être vide.

Corps de la réponse

Représente la réponse pour la méthode "monthly.list".

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "searchKeywordsCounts": [
    {
      object (SearchKeywordCount)
    }
  ],
  "nextPageToken": string
}
Champs
searchKeywordsCounts[]

object (SearchKeywordCount)

Termes de recherche qui ont été utilisés pour trouver une entreprise.
nextPageToken

string (bytes format)

Jeton indiquant le dernier résultat paginé renvoyé. Elle peut être utilisée par les requêtes suivantes visant à obtenir la "page" de mots clés suivante. Elle ne sera présente que lorsqu'il y aura davantage de résultats à renvoyer.

Chaîne encodée en base64.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/business.manage

Pour en savoir plus, consultez la présentation d'OAuth 2.0.

MonthlyRange

Période indiquant une période mensuelle (incluses).

Représentation JSON 
{
  "startMonth": {
    object (Date)
  },
  "endMonth": {
    object (Date)
  }
}
Champs
startMonth

object (Date)

Obligatoire. Inclus : seuls les champs d'année et de mois seront pris en compte
endMonth

object (Date)

Obligatoire. Inclus : seuls les champs d'année et de mois seront pris en compte

SearchKeywordCount

Représente un seul mot clé de recherche et sa valeur.

Représentation JSON 
{
  "searchKeyword": string,
  "insightsValue": {
    object (InsightsValue)
  }
}
Champs
searchKeyword

string

Chaîne en minuscules saisie par l'utilisateur.
insightsValue

object (InsightsValue)

L'une des valeurs suivantes: 1) La somme du nombre d'utilisateurs uniques ayant utilisé le mot clé au cours d'un mois donné, pour chaque mois demandé. 2) Un seuil qui indique que la valeur réelle est inférieure à ce seuil.

InsightsValue

Représente une valeur d'insights.

Représentation JSON 
{

  // Union field InsightsValue can be only one of the following:
  "value": string,
  "threshold": string
  // End of list of possible types for union field InsightsValue.
}
Champs
Champ d'union InsightsValue. Représente qu'un seul des champs proto suivants doit être présent. InsightsValue ne peut être qu'un des éléments suivants :
value

string (int64 format)

Représente la valeur réelle.
threshold

string (int64 format)

Représente le seuil en dessous duquel la valeur réelle se situe.