कॉन्फ़िगरेशन

Google Ads API की PHP क्लाइंट लाइब्रेरी में आपको कई कॉन्फ़िगरेशन सेटिंग मिलती हैं. का इस्तेमाल करके लाइब्रेरी के काम करने के तरीके को पसंद के मुताबिक बना सकते हैं.

कॉन्फ़िगरेशन फ़ाइल

इनमें से ज़्यादातर कॉन्फ़िगरेशन सेटिंग को यहां सेव किया जा सकता है ini और क्लाइंट इंस्टैंशिएट करते समय उनका इस्तेमाल करें, उदाहरण के लिए, google_ads_php.ini.

क्रेडेंशियल और क्लाइंट बिल्डर, दोनों में लोड करने के लिए fromFile तरीके उपलब्ध हैं सेटिंग:

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile('/path/to/google_ads_php.ini')
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

अगर आर्ग्युमेंट के तौर पर, कॉन्फ़िगरेशन फ़ाइल का कोई पाथ नहीं दिया गया है, तो fromFile विधियों को डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल पाथ से लोड किया जाता है, जो कि:

1. एनवायरमेंट वैरिएबल की वैल्यू को अगर सेट हो, तो GOOGLE_ADS_CONFIGURATION_FILE_PATH.
2. अगर ऐसा नहीं है, तो आपकी HOME डायरेक्ट्री में मौजूद google_ads_php.ini फ़ाइल.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->fromFile()
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->fromFile()
    ->withOAuth2Credential($oAuth2Credential)
    ->build();

डाइनैमिक कॉन्फ़िगरेशन

क्लाइंट इंस्टैंशिएट करते समय, इन कॉन्फ़िगरेशन सेटिंग को डाइनैमिक तौर पर सेट किया जा सकता है.

$oAuth2Credential = (new OAuth2TokenBuilder())
    ->withClientId('INSERT_CLIENT_ID')
    // ...
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    ->withDeveloperToken('INSERT_DEVELOPER_TOKEN_HERE')
    // ...
    ->build();

कॉन्फ़िगरेशन एनवायरमेंट वैरिएबल

एनवायरमेंट वैरिएबल से कॉन्फ़िगरेशन की कुछ सेटिंग तब सेट की जा सकती हैं, जब इंस्टैंशिएट करने वाले क्लाइंट (यह देखें सूची).

क्रेडेंशियल और क्लाइंट बिल्डर, दोनों ही fromEnvironmentVariables की सुविधा देते हैं इन तरीकों का इस्तेमाल करके, एनवायरमेंट वैरिएबल से सेटिंग लोड करें:

ध्यान दें: सेट नहीं किए गए एनवायरमेंट वैरिएबल को शामिल नहीं किया जाता.

$oAuth2Credential = (new OAuth2TokenBuilder())
    // ...
    ->fromEnvironmentVariables()
    ->build();

$googleAdsClient = (new GoogleAdsClientBuilder())
    ->withOAuth2Credential($oAuth2Credential)
    // ...
    ->fromEnvironmentVariables()
    ->build();

कॉन्फ़िगरेशन फ़ील्ड

ध्यान दें: फ़ील्ड grpcChannelCredential, unaryMiddlewares, streamingMiddlewares और grpcInterceptors को किसी कॉन्फ़िगरेशन से सेट नहीं किया जा सकता है, लेकिन सिर्फ़ डाइनैमिक तौर पर.

कॉन्फ़िगरेशन सेटिंग, कैटगरी में व्यवस्थित किए गए कई फ़ील्ड के साथ काम करती हैं.

1. OAuth2TokenBuilder में इस्तेमाल किए गए फ़ील्ड:
   • ऐप्लिकेशन मोड
     • [OAUTH2] clientId: आपका OAuth2 क्लाइंट आईडी.
     • [OAUTH2] clientSecret: आपका OAuth2 क्लाइंट सीक्रेट.
     • [OAUTH2] refreshToken: आपका OAuth2 रीफ़्रेश टोकन.
   • सेवा खाते का मोड
     • [OAUTH2] jsonKeyFilePath: Json कुंजी फ़ाइल पाथ.
     • [OAUTH2] scopes: स्कोप.
     • [OAUTH2] impersonatedEmail: प्रतिरूपित करने के लिए ईमेल.
2. GoogleAdsClientBuilder में इस्तेमाल किए गए फ़ील्ड:
   • [GOOGLE_ADS] developerToken: एपीआई ऐक्सेस करने के लिए, आपका डेवलपर टोकन.
   • [GOOGLE_ADS] loginCustomerId: अधिकृत व्यक्ति का आईडी ग्राहक का नाम डालें.
   • [GOOGLE_ADS] linkedCustomerId: लिंक किया गया ग्राहक आईडी.
   • [LOGGING] logFilePath: लॉग करने के लिए फ़ाइल पाथ.
   • [LOGGING] logLevel: लॉगिंग लेवल.
   • [CONNECTION] proxy: इंटरनेट कनेक्टिविटी के लिए इस्तेमाल किया जाने वाला प्रॉक्सी सर्वर यूआरएल.
   • [CONNECTION] transport: परिवहन.
   • [CONNECTION] grpcChannelIsSecure: gRPC चैनल सुरक्षित है या नहीं.
   • [CONNECTION] grpcChannelCredential: gRPC चैनल के क्रेडेंशियल.
   • [CONNECTION] unaryMiddlewares: निजी मिडलवेयर.
   • [CONNECTION] streamingMiddlewares: स्ट्रीमिंग मिडलवेयर.
   • [CONNECTION] grpcInterceptors: gRPC इंटरसेप्टर.
3. [GAPIC] useGapicV2Source: GAPIC v2 सोर्स का इस्तेमाल करना है या नहीं कोड का इस्तेमाल करें.

कॉन्फ़िगरेशन की पुष्टि करना

क्लाइंट और अपवादों को इंस्टैंशिएट करते समय, कॉन्फ़िगरेशन सेटिंग की जांच की जाती है अमान्य होने पर उन्हें फेंक दिया जाता है. यहां नियम दिए गए हैं:

1. [OAUTH2] फ़ील्ड को ऐप्लिकेशन मोड और सेवा, दोनों के लिए सेट नहीं किया जाना चाहिए खाता मोड का इस्तेमाल करें.
2. इस्तेमाल करते समय [OAUTH2] jsonKeyFilePath और [OAUTH2] scopes सेट होने चाहिए सेवा खाते वाले मोड का इस्तेमाल करें.
3. [OAUTH2] clientId, [OAUTH2] clientSecret, और [OAUTH2] refreshToken को यह ज़रूरी है ऐप्लिकेशन मोड का उपयोग करते समय सेट की जाएगी.
4. [GOOGLE_ADS] developerToken को हमेशा सेट करना चाहिए.
5. अगर यह नीति सेट है, तो [GOOGLE_ADS] loginCustomerId और [GOOGLE_ADS] linkedCustomerId धनात्मक संख्याएं होनी चाहिए.
6. अगर यह नीति सेट की जाती है, तो [CONNECTION] proxy एक मान्य यूआरएल होना चाहिए (फ़िल्टर देखें FILTER_VALIDATE_URL).
7. अगर यह नीति सेट की जाती है, तो [LOGGING] logLevel एक मान्य पीएसआर लॉग होना चाहिए लेवल में बड़े अक्षर, जैसे कि INFO.
8. अगर यह नीति सेट है, तो [CONNECTION] transport, grpc या rest होना चाहिए.
9. अगर [CONNECTION] transport को grpc पर सेट किया गया है, तो gRPC ट्रांसपोर्ट ज़रूरी है वातावरण की मदद से काम करता है (गाइड ट्रांसपोर्ट देखें).
10. अगर [CONNECTION] transport को grpc पर सेट नहीं किया गया है, तो [CONNECTION] grpcChannelIsSecure, true होना चाहिए.
11. [CONNECTION] grpcChannelCredential को सिर्फ़ तब सेट किया जा सकता है, जब [CONNECTION] transport को grpc पर सेट किया गया हो.
12. [CONNECTION] grpcChannelCredential को सिर्फ़ तब सेट किया जा सकता है, जब [CONNECTION] grpcChannelIsSecure true पर हो.