Utilisation de base

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

use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClient;
use Google\Ads\GoogleAds\Lib\V22\GoogleAdsClientBuilder;
use Google\Ads\GoogleAds\Lib\V22\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 GoogleAdsClient est la plus importante de la bibliothèque PHP de l'API Google Ads. Il vous permet de créer des objets client de service préconfigurés qui peuvent être utilisés pour effectuer des appels d'API. GoogleAdsClient fournit différentes manières de l'instancier :

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

Pour en savoir plus, consultez le guide de configuration.

Pour configurer un objet GoogleAdsClient, créez un objet OAuth2TokenBuilder et un objet GoogleAdsClientBuilder, 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 forcément 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. Il contient des informations qui vous aideront à comprendre ce qui s'est passé :

use Google\Ads\GoogleAds\Lib\V22\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
    );
}