Passer au contenu principal

Introduction

Google Search est un service de recherche fourni par Ace Data Cloud, l’API de recherche Google. Grâce à l’API unifiée d’Ace Data Cloud, vous pouvez intégrer rapidement Google Search en Python pour réaliser des recherches web, d’images, d’actualités, de cartes, de vidéos, etc.

Prérequis

  • Posséder un compte Ace Data Cloud et obtenir un Token API
  • Environnement Python 3.7 ou supérieur
  • Installer la bibliothèque requests : pip install requests

Utilisation de base

Le point d’accès principal pour appeler l’API Google Search est :
POST https://api.acedata.cloud/serp/google
Exemple complet de code Python :
import requests

url = "https://api.acedata.cloud/serp/google"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "query": "artificial intelligence latest news",
    "type": "search",
    "number": 10,
    "language": "en",
    "country": "US"
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Veuillez remplacer YOUR_API_TOKEN par le Token réel obtenu sur la plateforme Ace Data Cloud.

Traitement de la réponse

Après un appel réussi, l’API retourne des données au format JSON. Il est recommandé de vérifier le code HTTP :
if response.status_code == 200:
    result = response.json()
    print("Appel réussi :", result)
else:
    print(f"Échec de l'appel, code d'état : {response.status_code}")
    print(response.text)

Utilisation avancée

Pour les API supportant les tâches asynchrones, vous pouvez obtenir les résultats via une URL de callback :
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Les résultats seront envoyés à votre serveur via l'URL de callback

Gestion des erreurs

Codes d’erreur courants :
Code d’étatDescription
401Échec d’authentification, vérifiez le Token API
403Solde insuffisant ou accès refusé
429Limite de fréquence dépassée
500Erreur interne du serveur

Étapes suivantes