Exemples PHP
Vue d'ensemble
Tous les exemples de code de cette section utilisent les classes suivantes.
La classe Request utilise cURL pour effectuer les requêtes à l'API.
La classe Response contient la réponse de l'API et les informations sur le code d'état renvoyé.
Connexion
Il existe deux options pour demander la connexion route :
avec un nom d'utilisateur et un mot de passe
avec un jeton API (jeton d'accès)
Exemple de connexion avec les paramètres nom d'utilisateur et mot de passe.
<?php
// Inclure les classes Request et Response
$url = 'https://api.example.com/v2/login';
$params = array(
'username' => 'sample_username',
'password' => 'sample_password'
);
// Créer un nouvel objet Request
$request = new Request($url, 'POST', $params);
// Envoyer la requête
$request->send();
// Obtenir l'objet Response
$response = $request->getResponse();
if($response->getStatusCode() == 200) {
// Récupérer les détails du jeton de session
$token = $response->getBodyDecoded();
print_r($token);
}
else {
echo $response->getStatusCode() . PHP_EOL;
echo $response->getReasonPhrase() . PHP_EOL;
echo $response->getBody() . PHP_EOL;
}
?>Exemple de connexion avec un jeton API (jeton d'accès)
Authentification
Chaque requête liée au contenu utilisateur nécessite un Autorisation en-tête à définir, avec une valeur contenant le type de jeton et le jeton de session reçu de la requête de connexion à l'API.
Une requête valide /login requête à l'API renverra la charge utile JSON suivante.
Le Jeton de session doit être inclus dans toutes les requêtes ultérieures liées au contenu utilisateur vers l'API.
Le type doit être ajouté au début du jeton, séparé par un seul espace.
Le expires_in est la durée en secondes pendant laquelle le jeton sera valide. Une fois ce délai expiré, un nouveau jeton devra être obtenu via la requête /login.
Exemple d'obtention et de définition de l'en-tête d'autorisation avec nom d'utilisateur et mot de passe
Exemple d'obtention et de définition de l'en-tête d'autorisation avec un jeton API
Collections
Voici un exemple de requête pour obtenir la Navigateurs collection.
Statistiques
Voici un exemple de requête d'annonceur pour statistics/a/date.
Dans le cas où additional_group_by la valeur est définie, la requête sera regroupée par le champ principal de la route et le ou les champs supplémentaires.
Exemple de statistiques par date filtrées par l'ID de campagne 1234.
Exemple de statistiques par date avec regroupement supplémentaire par campagne.
post /statistics/a/global
Obtenir les statistiques globales de l'annonceur
Exemple 1 de statistiques globales
Exemple de requête pour les statistiques globales.
Seul le group_by paramètre est obligatoire. Les valeurs par défaut des autres paramètres se trouvent Ici.
Veuillez noter que les routes de statistiques globales (statistics/a/global, statistics/p/global) ont un format de paramètres différent.
Exemple 2 de statistiques globales
Obtenir les statistiques par date, y compris les totaux cumulés.
Exemple 3 de statistiques globales
Obtenir les statistiques par campagne et par pays filtrées par une date spécifique, triées par impressions.
Exemple 4 de statistiques globales
Obtenir les statistiques des éditeurs par zone et par pays filtrées par un système d'exploitation spécifique.
Mis à jour
Ce contenu vous a-t-il été utile ?
