Method: locations.searchkeywords.impressions.monthly.list

Affiche les mots clés de recherche utilisés pour trouver une entreprise dans la recherche ou sur Google Maps. Chaque mot clé pour le Réseau de Recherche s'accompagne d'impressions cumulées sur une base mensuelle.

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. Plage de mois sur laquelle cumuler les impressions des mots clés pour le Réseau de Recherche.
pageSize

integer

Facultatif. Nombre de résultats demandés. La taille de page par défaut est 100. La taille de la page peut être définie sur un maximum de 100.
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 month.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 utilisés pour trouver une entreprise.
nextPageToken

string (bytes format)

Jeton indiquant le dernier résultat paginé renvoyé. Elle peut être utilisée par des requêtes successives pour obtenir la "page" suivante de mots clés. Il ne sera présent 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 (les deux inclus).

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

object (Date)

Obligatoire. Inclusif : seuls les champs "year" (année) et "month" (mois) sont pris en compte.
endMonth

object (Date)

Obligatoire. Inclusif : seuls les champs "year" (année) et "month" (mois) sont pris en compte.

SearchKeywordCount

Représente un seul mot clé pour le Réseau 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) Nombre total d'utilisateurs uniques ayant utilisé le mot clé au cours d'un mois donné, cumulé pour chaque mois demandé. 2) Un seuil indiquant 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 le fait 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 se situe la valeur réelle.