इस पेज का अनुवाद Cloud Translation API से किया गया है.

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

क्लाइंट को कॉन्फ़िगर करने के कई अलग-अलग तरीके हैं.

YAML फ़ाइल का इस्तेमाल करके कॉन्फ़िगरेशन करने की सुविधा

किसी ऐसे क्लाइंट को शुरू करते समय YAML फ़ाइल इस्तेमाल की जा सकती है जिसमें अनुरोध करने के लिए, पुष्टि करने से जुड़ी ज़रूरी जानकारी होती है. इस फ़ाइल को तब ऐक्सेस किया जाता है, जब load_from_storage तरीके का इस्तेमाल करके क्लाइंट को शुरू किया जाता है. इस फ़ाइल को जनरेट करने का सबसे आसान तरीका, GitHub रिपॉज़िटरी से google-ads.yaml उदाहरण को कॉपी करना है. साथ ही, अपने क्रेडेंशियल को शामिल करने के लिए इसमें बदलाव करना है. इनमें आपका डेवलपर टोकन, रीफ़्रेश टोकन, क्लाइंट आईडी, और क्लाइंट सीक्रेट शामिल हैं.

यह बताने के लिए कि google-ads.yaml फ़ाइल कहां मौजूद है, इसे कॉल करते समय पाथ को स्ट्रिंग के तौर पर पास किया जा सकता है.

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage("path/to/google-ads.yaml")

किसी खास एनवायरमेंट वैरिएबल को तय करके भी पाथ तय किया जा सकता है:

import os

os.environ["GOOGLE_ADS_CONFIGURATION_FILE_PATH"] = "path/to/google-ads.yaml"
from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()

अगर दोनों वैल्यू दी गई हैं—और तरीके में एक पाथ पास किया जाता है और ऊपर दिया गया एनवायरमेंट वैरिएबल मौजूद है, तो लाइब्रेरी, तरीके में पास किए गए पाथ को प्राथमिकता देगी.

अगर पाथ उपलब्ध नहीं कराया जाता है, तो लाइब्रेरी, फ़ाइल के लिए आपकी $HOME डायरेक्ट्री में दिखेगी:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_storage()

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

आपके सभी क्लाइंट कॉन्फ़िगरेशन को एनवायरमेंट वैरिएबल के तौर पर स्टोर किया जा सकता है. इन्हें क्लाइंट के load_from_env तरीके का इस्तेमाल करते समय पढ़ा जाएगा. एनवायरमेंट वैरिएबल के नाम वही होने चाहिए जो google-ads.yaml फ़ाइल में दिए गए हैं. हालांकि, सभी के नाम अपरकेस और GOOGLE_ADS_ से पहले शुरू होने चाहिए. उदाहरण के लिए, client_id को GOOGLE_ADS_CLIENT_ID के तौर पर सेव किया जाना चाहिए.

आम तौर पर, एनवायरमेंट वैरिएबल किसी बैश कॉन्फ़िगरेशन फ़ाइल में बताए जाते हैं. जैसे, $HOME डायरेक्ट्री में मौजूद .bashrc या .bash_profile फ़ाइल. इन्हें कमांड लाइन का इस्तेमाल करके भी तय किया जा सकता है. ध्यान दें कि इन निर्देशों से यह माना जा सकता है कि bash का इस्तेमाल किया जा रहा है. अगर किसी दूसरे शेल का इस्तेमाल किया जा रहा है, तो आपको इस्तेमाल किए जा रहे शेल में एनवायरमेंट वैरिएबल सेट करने के तरीके से जुड़े दस्तावेज़ देखने की ज़रूरत पड़ सकती है.

यहां टर्मिनल का इस्तेमाल करके, .bashrc फ़ाइल का इस्तेमाल करके एनवायरमेंट वैरिएबल तय करने के कुछ बुनियादी तरीके दिए गए हैं:

# Append the line "export GOOGLE_ADS_CLIENT_ID=1234567890" to
# the bottom of your .bashrc file.
$ echo "export GOOGLE_ADS_CLIENT_ID=1234567890" >> ~/.bashrc
# Update your bash environment to use the most recently updated
# version of your .bashrc file.
$ src ~/.bashrc

एनवायरमेंट वैरिएबल को भी अपने टर्मिनल इंस्टेंस में सीधे कमांड लाइन से सेट किया जा सकता है:

$ export GOOGLE_ADS_CLIENT_ID=1234567890
$ echo $GOOGLE_ADS_CLIENT_ID
1234567890

load_from_env वाला तरीका, Python के पहले से मौजूद os मॉड्यूल पर environ एट्रिब्यूट से कॉन्फ़िगरेशन डेटा लोड करता है. उदाहरण के लिए: os.environ["GOOGLE_ADS_CLIENT_ID"]

यहां एनवायरमेंट वैरिएबल से कॉन्फ़िगरेशन के साथ क्लाइंट इंस्टेंस शुरू करने के तरीके का उदाहरण दिया गया है:

from google.ads.googleads.client import GoogleAdsClient
client = GoogleAdsClient.load_from_env()

एनवायरमेंट वैरिएबल की मदद से logging को कॉन्फ़िगर करने के लिए, कॉन्फ़िगरेशन वैल्यू एक JSON ऑब्जेक्ट होना चाहिए. यह वैल्यू, सैंपल google-ads.yaml कॉन्फ़िगरेशन फ़ाइल में मौजूद YAML कुंजियों के स्ट्रक्चर से मेल खानी चाहिए.

यहां दिए गए उदाहरण में बताया गया है कि .bashrc फ़ाइल का इस्तेमाल करके, इसे कैसे सेट किया जा सकता है:

export GOOGLE_ADS_LOGGING='{
  "version": 1,
  "disable_existing_loggers": false,
  "formatters": {
    "default_fmt": {
      "format": "[%(asctime)s - %(levelname)s] %(message).5000s",
      "datefmt": "%Y-%m-%d %H:%M:%S"
    }
  },
  "handlers": {
    "default_handler": {
      "class": "logging.StreamHandler",
      "formatter": "default_fmt"
    }
  },
  "loggers": {
    "": {
      "handlers": ["default_handler"],
      "level": "INFO"
    }
  }
}'

YAML स्ट्रिंग का इस्तेमाल करने वाला कॉन्फ़िगरेशन

अगर आपने YAML फ़ाइल को मेमोरी में पढ़ा है, तो उसे शुरू करने पर सीधे क्लाइंट को दिया जा सकता है. ऐसा करने के लिए, सिर्फ़ load_from_string तरीके का इस्तेमाल करें.

from google.ads.googleads.client import GoogleAdsClient

with open("/path/to/yaml", "rb") as handle:
    yaml = handle.read()

client = GoogleAdsClient.load_from_string(yaml)

`dict` का इस्तेमाल करके कॉन्फ़िगरेशन किया गया है

dict को सीधे load_from_dict तरीके पर पास किया जा सकता है. उदाहरण के लिए:

from google.ads.googleads.client import GoogleAdsClient

credentials = {
    "developer_token": "abcdef123456",
    "refresh_token": "1//0abcdefghijklABCDEF",
    "client_id": "123456-abcdef.apps.googleusercontent.com",
    "client_secret": "aBcDeFgHiJkL"}

client = GoogleAdsClient.load_from_dict(credentials)