अपना क्लाइंट इंस्टॉल और कॉन्फ़िगर करें

हमारा सुझाव है कि Display & Video 360 API के साथ, Google API क्लाइंट लाइब्रेरी का इस्तेमाल करें. क्लाइंट लाइब्रेरी का इस्तेमाल करने पर, आपको एचटीटीपी अनुरोधों को मैन्युअल तरीके से बनाने और जवाबों को पार्स करने की ज़रूरत नहीं होती. क्लाइंट लाइब्रेरी की मदद से, ऐसे कॉल के लिए भाषा का बेहतर इंटिग्रेशन, बेहतर सुरक्षा, और सहायता मिलती है जिनमें उपयोगकर्ता की अनुमति ज़रूरी होती है.

Display & Video 360 API को एचटीटीपी और JSON पर बनाया गया है. अगर आपको यह तरीका पसंद नहीं है, तो अनुरोध करने और जवाबों को पार्स करने के लिए, किसी भी स्टैंडर्ड एचटीटीपी क्लाइंट का इस्तेमाल किया जा सकता है.

क्लाइंट लाइब्रेरी इंस्टॉल करना

हम ऐसी क्लाइंट लाइब्रेरी उपलब्ध कराते हैं जो कई प्रोग्रामिंग भाषाओं में Display & Video 360 API के साथ काम करती हैं. क्लाइंट लाइब्रेरी की पूरी सूची देखने के लिए, हमारा सैंपल और लाइब्रेरी पेज देखें.

Display & Video 360 API डेवलपर गाइड में, इन भाषाओं के लिए कोड स्निपेट दिए गए हैं:

हमारी गाइड में कोड स्निपेट के अलावा, हम इन भाषाओं में इंटिग्रेशन के पूरे उदाहरण भी देते हैं. इन सैंपल के लिए, Display & Video 360 API के उदाहरणों वाली GitHub रिपॉज़िटरी देखें.

अपने क्लाइंट को कॉन्फ़िगर करना

OAuth 2.0 क्रेडेंशियल और इंस्टॉल की गई क्लाइंट लाइब्रेरी की मदद से, Display & Video 360 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.displayvideo.v4.DisplayVideo;
import com.google.api.services.displayvideo.v4.DisplayVideo.Advertisers;
import com.google.api.services.displayvideo.v4.model.Advertiser;
import com.google.api.services.displayvideo.v4.model.ListAdvertisersResponse;
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.
DisplayVideo service =
    new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
        .setApplicationName("displayvideo-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://displayvideo.googleapis.com/$discovery/rest?version=v4'

# Build the API service.
service = discovery.build(
    'displayvideo',
    'v4',
    discoveryServiceUrl=discovery_url,
    credentials=credentials)

PHP

इस सैंपल में यह माना गया है कि PHP को बिल्ट-इन वेब सर्वर के साथ चलाया जा रहा है. साथ ही, आपने क्रेडेंशियल को कॉन्फ़िगर किया है, ताकि उन्हें काम के वेब पेज पर रीडायरेक्ट किया जा सके. उदाहरण के लिए, index.php फ़ाइल में मौजूद इस कोड को, यहां दी गई कमांड और क्रेडेंशियल का इस्तेमाल करके चलाया जा सकता है. ये क्रेडेंशियल, पुष्टि के बाद http://localhost:8000 पर रीडायरेक्ट करने के लिए कॉन्फ़िगर किए गए हैं:

php -S localhost:8000 -t ./

Google API PHP Client डाउनलोड और इंस्टॉल करें.

हमारा सुझाव है कि आप Composer का इस्तेमाल करें:
```
composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0
```
इंस्टॉल करने के बाद, ऑटोलoader को शामिल करना न भूलें:
```
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('DV360 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_DisplayVideo($client);
```