- Requête HTTP
- Paramètres de chemin d'accès
- Paramètres de requête
- Corps de la requête
- Corps de la réponse
- Champs d'application des autorisations
- MonthlyRange
- SearchKeywordCount
- InsightsValue
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 |
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 |
Obligatoire. Période en mois pendant laquelle les impressions des mots clés pour le Réseau de Recherche sont agrégées. |
pageSize |
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 |
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 ( |
Champs | |
---|---|
searchKeywordsCounts[] |
Termes de recherche qui ont été utilisés pour trouver une entreprise. |
nextPageToken |
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 ( |
Champs | |
---|---|
startMonth |
Obligatoire. Inclus : seuls les champs d'année et de mois seront pris en compte |
endMonth |
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 ( |
Champs | |
---|---|
searchKeyword |
Chaîne en minuscules saisie par l'utilisateur. |
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 |
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 |
Représente la valeur réelle. |
threshold |
Représente le seuil en dessous duquel la valeur réelle se situe. |