हमारा सुझाव है कि आप Bid Manager API के साथ Google API क्लाइंट लाइब्रेरी का इस्तेमाल करें. इससे आपको एचटीटीपी अनुरोधों और जवाबों को मैन्युअल तरीके से प्रोसेस नहीं करना पड़ेगा. Google API क्लाइंट लाइब्रेरी की मदद से, ऐसे कॉल के लिए भाषा का बेहतर इंटिग्रेशन, बेहतर सुरक्षा, और सहायता मिलती है जिनमें उपयोगकर्ता की अनुमति ज़रूरी होती है.
Bid Manager API को एचटीटीपी और JSON पर बनाया गया है. अगर आपको अनुरोधों और जवाबों को मैन्युअल तरीके से प्रोसेस करना है, तो किसी भी स्टैंडर्ड एचटीटीपी क्लाइंट का इस्तेमाल किया जा सकता है.
क्लाइंट लाइब्रेरी इंस्टॉल करना
हम क्लाइंट लाइब्रेरी ऑफ़र करते हैं. ये लाइब्रेरी, कई प्रोग्रामिंग भाषाओं में Bid Manager API के साथ काम करती हैं. क्लाइंट लाइब्रेरी की पूरी सूची देखने के लिए, सैंपल और लाइब्रेरी टैब देखें.
Bid Manager API के डेवलपर गाइड में, इन तीन भाषाओं के लिए कोड स्निपेट दिए गए हैं:
इन भाषाओं में इंटिग्रेशन के पूरे उदाहरण देखने के लिए, हमारे Bid Manager API के उदाहरणों के लिए GitHub डेटा स्टोर करने की जगह देखें.
अपने क्लाइंट को कॉन्फ़िगर करना
OAuth 2.0 क्रेडेंशियल और इंस्टॉल की गई क्लाइंट लाइब्रेरी की मदद से, Bid Manager API का इस्तेमाल किया जा सकता है. अपने क्लाइंट को अनुमति देने और कॉन्फ़िगर करने का तरीका यहां बताया गया है:
Java
ज़रूरी लाइब्रेरी इंपोर्ट करें.
import static java.nio.charset.StandardCharsets.UTF_8; import com.google.api.client.auth.oauth2.Credential; import com.google.api.client.extensions.java6.auth.oauth2.AuthorizationCodeInstalledApp; import com.google.api.client.extensions.jetty.auth.oauth2.LocalServerReceiver; import com.google.api.client.googleapis.auth.oauth2.GoogleAuthorizationCodeFlow; import com.google.api.client.googleapis.auth.oauth2.GoogleClientSecrets; import com.google.api.client.googleapis.util.Utils; import com.google.api.services.doubleclickbidmanager.DoubleClickBidManager; import java.io.Reader; import java.nio.file.Files; import java.nio.file.Paths;
क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति के क्रेडेंशियल जनरेट करें.
पहली बार यह चरण पूरा करने पर, आपसे अपने ब्राउज़र में अनुमति का प्रॉम्प्ट स्वीकार करने के लिए कहा जाता है. इसे स्वीकार करने से पहले, पक्का करें कि आपने उस Google खाते से साइन इन किया हो जिसके पास Display & Video 360 का ऐक्सेस हो. आपका ऐप्लिकेशन, फ़िलहाल साइन इन किए गए खाते की ओर से डेटा ऐक्सेस करने के लिए अनुमति पा लेगा.
// Read client secrets file. GoogleClientSecrets clientSecrets; try (Reader reader = Files.newBufferedReader(Paths.get(path-to-client-secrets-file), UTF_8)) { clientSecrets = GoogleClientSecrets.load(Utils.getDefaultJsonFactory(), reader); } // Generate authorization credentials. // Set up the authorization code flow. GoogleAuthorizationCodeFlow flow = new GoogleAuthorizationCodeFlow.Builder( Utils.getDefaultTransport(), Utils.getDefaultJsonFactory(), clientSecrets, oauth-scopes) .build(); Credential credential = new AuthorizationCodeInstalledApp(flow, new LocalServerReceiver()).authorize("user");
अनुमति वाला एपीआई क्लाइंट बनाएं.
// Create authorized API client. DoubleClickBidManager service = new DoubleClickBidManager.Builder(credential.getTransport(), credential.getJsonFactory(), credential) .setApplicationName("bidmanager-java-installed-app-sample") .build();
Python
ज़रूरी लाइब्रेरी इंपोर्ट करें.
from google_auth_oauthlib.flow import InstalledAppFlow from googleapiclient import discovery
क्लाइंट सीक्रेट फ़ाइल लोड करें और अनुमति के क्रेडेंशियल जनरेट करें.
पहली बार यह चरण पूरा करने पर, आपसे अपने ब्राउज़र में अनुमति का प्रॉम्प्ट स्वीकार करने के लिए कहा जाता है. इसे स्वीकार करने से पहले, पक्का करें कि आपने उस Google खाते से साइन इन किया हो जिसके पास Display & Video 360 का ऐक्सेस हो. आपका ऐप्लिकेशन, फ़िलहाल साइन इन किए गए खाते की ओर से डेटा ऐक्सेस करने के लिए अनुमति पा लेगा.
# Set up a flow object to create the credentials using the # client secrets file and OAuth scopes. credentials = InstalledAppFlow.from_client_secrets_file( path-to-client-secrets-file, oauth-scopes).run_local_server()
अनुमति वाला एपीआई क्लाइंट बनाएं.
# Build the discovery document URL. discovery_url = f'https://doubleclickbidmanager.googleapis.com/$discovery/rest?version=v2' # Build the API service. service = discovery.build( 'doubleclickbidmanager', 'v2', discoveryServiceUrl=discovery_url, credentials=credentials)
PHP
इस सैंपल में यह माना गया है कि आप PHP को, वेब सर्वर के साथ चला रहे हैं और आपने अपने क्रेडेंशियल को, काम के वेब पेज पर रीडायरेक्ट करने के लिए कॉन्फ़िगर किया है. उदाहरण के लिए, index.php फ़ाइल में मौजूद इस कोड को, इस कमांड और क्रेडेंशियल का इस्तेमाल करके चलाया जा सकता है. इन क्रेडेंशियल को, पुष्टि के बाद http://localhost:8000 पर रीडायरेक्ट करने के लिए कॉन्फ़िगर किया गया है:
php -S localhost:8000 -t ./Google API PHP क्लाइंट डाउनलोड और इंस्टॉल करें.
इसके लिए, Composer का इस्तेमाल करना बेहतर है:
composer require google/apiclient:^2.12.1इसे इंस्टॉल करने के बाद, ऑटलोडर को शामिल करना न भूलें
require_once '/path/to/your-project/vendor/autoload.php';Google_Client ऑब्जेक्ट बनाएं.
$client = new Google_Client();क्लाइंट सेट अप करें, ज़रूरत पड़ने पर पुष्टि करने वाले यूआरएल पर रीडायरेक्ट करें, और ऐक्सेस टोकन पाएं.
पहली बार यह चरण पूरा करने पर, आपसे अपने ब्राउज़र में अनुमति का प्रॉम्प्ट स्वीकार करने के लिए कहा जाता है. इसे स्वीकार करने से पहले, पक्का करें कि आपने उस Google खाते से साइन इन किया हो जिसके पास Display & Video 360 का ऐक्सेस हो. आपका ऐप्लिकेशन, फ़िलहाल साइन इन किए गए खाते की ओर से डेटा ऐक्सेस करने के लिए अनुमति पा लेगा.
// Set up the client. $client->setApplicationName('DBM API PHP Samples'); $client->addScope(oauth-scope); $client->setAccessType('offline'); $client->setAuthConfigFile(path-to-client-secrets-file); // If the code is passed, authenticate. If not, redirect to authentication page. if (isset($_GET['code'])) { $client->authenticate($_GET['code']); } else { $authUrl = $client->createAuthUrl(); header('Location: ' . $authUrl); } // Exchange authorization code for an access token. $accessToken = $client->getAccessToken(); $client->setAccessToken($accessToken);
Display &Video 360 API सेवा के लिए क्लाइंट बनाएं.
$service = new Google_Service_DoubleClickBidManager($client);