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
विधियों को डिफ़ॉल्ट कॉन्फ़िगरेशन फ़ाइल पाथ से लोड किया जाता है, जो कि:
- एनवायरमेंट वैरिएबल की वैल्यू को
अगर सेट हो, तो
GOOGLE_ADS_CONFIGURATION_FILE_PATH
. - अगर ऐसा नहीं है, तो आपकी
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();
कॉन्फ़िगरेशन फ़ील्ड
कॉन्फ़िगरेशन सेटिंग, कैटगरी में व्यवस्थित किए गए कई फ़ील्ड के साथ काम करती हैं.
OAuth2TokenBuilder
में इस्तेमाल किए गए फ़ील्ड:- ऐप्लिकेशन मोड
[OAUTH2] clientId
: आपका OAuth2 क्लाइंट आईडी.[OAUTH2] clientSecret
: आपका OAuth2 क्लाइंट सीक्रेट.[OAUTH2] refreshToken
: आपका OAuth2 रीफ़्रेश टोकन.
- सेवा खाते का मोड
[OAUTH2] jsonKeyFilePath
: Json कुंजी फ़ाइल पाथ.[OAUTH2] scopes
: स्कोप.[OAUTH2] impersonatedEmail
: प्रतिरूपित करने के लिए ईमेल.
- ऐप्लिकेशन मोड
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 इंटरसेप्टर.
[GAPIC] useGapicV2Source
: GAPIC v2 सोर्स का इस्तेमाल करना है या नहीं कोड का इस्तेमाल करें.
कॉन्फ़िगरेशन की पुष्टि करना
क्लाइंट और अपवादों को इंस्टैंशिएट करते समय, कॉन्फ़िगरेशन सेटिंग की जांच की जाती है अमान्य होने पर उन्हें फेंक दिया जाता है. यहां नियम दिए गए हैं:
[OAUTH2]
फ़ील्ड को ऐप्लिकेशन मोड और सेवा, दोनों के लिए सेट नहीं किया जाना चाहिए खाता मोड का इस्तेमाल करें.- इस्तेमाल करते समय
[OAUTH2] jsonKeyFilePath
और[OAUTH2] scopes
सेट होने चाहिए सेवा खाते वाले मोड का इस्तेमाल करें. [OAUTH2] clientId
,[OAUTH2] clientSecret
, और[OAUTH2] refreshToken
को यह ज़रूरी है ऐप्लिकेशन मोड का उपयोग करते समय सेट की जाएगी.[GOOGLE_ADS] developerToken
को हमेशा सेट करना चाहिए.- अगर यह नीति सेट है, तो
[GOOGLE_ADS] loginCustomerId
और[GOOGLE_ADS] linkedCustomerId
धनात्मक संख्याएं होनी चाहिए. - अगर यह नीति सेट की जाती है, तो
[CONNECTION] proxy
एक मान्य यूआरएल होना चाहिए (फ़िल्टर देखें FILTER_VALIDATE_URL). - अगर यह नीति सेट की जाती है, तो
[LOGGING] logLevel
एक मान्य पीएसआर लॉग होना चाहिए लेवल में बड़े अक्षर, जैसे किINFO
. - अगर यह नीति सेट है, तो
[CONNECTION] transport
,grpc
याrest
होना चाहिए. - अगर
[CONNECTION] transport
कोgrpc
पर सेट किया गया है, तो gRPC ट्रांसपोर्ट ज़रूरी है वातावरण की मदद से काम करता है (गाइड ट्रांसपोर्ट देखें). - अगर
[CONNECTION] transport
कोgrpc
पर सेट नहीं किया गया है, तो[CONNECTION] grpcChannelIsSecure
,true
होना चाहिए. [CONNECTION] grpcChannelCredential
को सिर्फ़ तब सेट किया जा सकता है, जब[CONNECTION] transport
कोgrpc
पर सेट किया गया हो.[CONNECTION] grpcChannelCredential
को सिर्फ़ तब सेट किया जा सकता है, जब[CONNECTION] grpcChannelIsSecure
true
पर हो.