Utilisation de base

L'utilisation de base de la bibliothèque cliente est la suivante :

use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V25\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V25\GoogleAdsException;
use Google\Ads\GoogleAds\Lib\OAuth2TokenBuilder;
use Google\ApiCore\ApiException;

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file and the
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

// Create the CampaignServiceClient.
$campaignServiceClient = $googleAdsClient->getCampaignServiceClient();

// Make calls to CampaignServiceClient.

Créer une instance GoogleAdsClient

La classe la plus importante de la bibliothèque PHP de l'API Google Ads est la classe GoogleAdsClient. Elle vous permet de créer des objets clients de service préconfigurés qui peuvent être utilisés pour effectuer des appels d'API. GoogleAdsClient propose différentes façons de l'instancier :

  • Utiliser un fichier google_ads_php.ini
  • Utiliser des variables d'environnement
  • Utiliser des setters sur GoogleAdsClientBuilder

Pour en savoir plus, consultez le guide de configuration.

Pour configurer un GoogleAdsClient objet, créez un OAuth2TokenBuilderobjet et un GoogleAdsClientBuilder objet, puis définissez les paramètres nécessaires :

// Generate a refreshable OAuth 2.0 credential for authentication.
$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

// Construct a Google Ads client configured from a properties file
$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->withLoginCustomerId(1234567890) // Replace 1234567890 with your login customer ID.
    ->build();

Créer un service

GoogleAdsClient fournit une méthode getter pour chaque objet client de service. Par exemple, pour créer une instance de CampaignServiceClient, appelez la méthode GoogleAdsClient->getCampaignServiceClient(), comme illustré dans l' exemple précédent.

Gestion des exceptions

Tous les appels d'API ne sont pas réussis. Le serveur peut générer des erreurs si vos appels d'API échouent pour une raison quelconque. Il est important de capturer les erreurs d'API et de les gérer de manière appropriée.

Une instance GoogleAdsException est générée lorsqu'une erreur d'API se produit. Elle contient des informations qui vous aident à comprendre le problème :

use Google\Ads\GoogleAds\Lib\V25\GoogleAdsException;
use Google\ApiCore\ApiException;

try {
    // Make your API call here.
} catch (GoogleAdsException $googleAdsException) {
    printf(
        "Request with ID '%s' has failed.%sGoogle Ads failure details:%s",
        $googleAdsException->getRequestId(),
        PHP_EOL,
        PHP_EOL
    );
    foreach ($googleAdsException->getGoogleAdsFailure()->getErrors() as $error) {
        printf(
            "\t%s: %s%s",
            $error->getErrorCode()->getErrorCode(),
            $error->getMessage(),
            PHP_EOL
        );
    }
} catch (ApiException $apiException) {
    printf(
        "ApiException was thrown with message '%s'.%s",
        $apiException->getMessage(),
        PHP_EOL
    );
}