আপনার ক্লায়েন্ট ইনস্টল এবং কনফিগার করুন

আমরা আপনাকে ডিসপ্লে অ্যান্ড ভিডিও ৩৬০ এপিআই (Display & Video 360 API)-এর সাথে গুগল এপিআই ক্লায়েন্ট লাইব্রেরিগুলো ব্যবহার করার পরামর্শ দিই। ক্লায়েন্ট লাইব্রেরি ব্যবহার করলে, আপনাকে ম্যানুয়ালি এইচটিটিপি (HTTP) রিকোয়েস্ট করতে এবং রেসপন্স পার্স করতে হবে না। ক্লায়েন্ট লাইব্রেরিগুলো উন্নততর ল্যাঙ্গুয়েজ ইন্টিগ্রেশন, উন্নত নিরাপত্তা এবং ব্যবহারকারীর অনুমোদন প্রয়োজন এমন কল করার সুবিধা প্রদান করতে পারে।

ডিসপ্লে ও ভিডিও ৩৬০ এপিআইটি এইচটিটিপি এবং জেএসওএন-এর উপর ভিত্তি করে নির্মিত। আপনি চাইলে, অনুরোধ পাঠাতে এবং প্রতিক্রিয়া পার্স করতে যেকোনো সাধারণ এইচটিটিপি ক্লায়েন্ট ব্যবহার করতে পারেন।

Install a client library

আমরা বিভিন্ন প্রোগ্রামিং ভাষায় ডিসপ্লে ও ভিডিও ৩৬০ এপিআই সমর্থনকারী ক্লায়েন্ট লাইব্রেরি সরবরাহ করি। ক্লায়েন্ট লাইব্রেরির সম্পূর্ণ তালিকার জন্য আমাদের স্যাম্পল ও লাইব্রেরি পৃষ্ঠাটি দেখুন।

ডিসপ্লে ও ভিডিও ৩৬০ এপিআই ডেভেলপার গাইডগুলোতে নিম্নলিখিত ভাষাগুলোর জন্য কোড স্নিপেট দেওয়া আছে:

আমাদের গাইডগুলিতে কোড স্নিপেট ছাড়াও, আমরা এই ভাষাগুলিতে সম্পূর্ণ ইন্টিগ্রেশন উদাহরণ প্রদান করি। এই নমুনাগুলির জন্য আমাদের ডিসপ্লে ও ভিডিও ৩৬০ এপিআই উদাহরণ গিটহাব রিপোজিটরি দেখুন।

Configure your client

OAuth 2.0 ক্রেডেনশিয়াল এবং একটি ইনস্টল করা ক্লায়েন্ট লাইব্রেরি থাকলেই, আপনি Display & Video 360 API ব্যবহার করার জন্য প্রস্তুত। আপনার ক্লায়েন্টকে কীভাবে অনুমোদন ও কনফিগার করবেন তা নিচে দেওয়া হলো:

Java

  1. Import the necessary libraries.

    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;
    
  2. ক্লায়েন্ট সিক্রেটস ফাইলটি লোড করুন এবং অনুমোদন ক্রেডেনশিয়াল তৈরি করুন।

    আপনি যখন প্রথমবার এই ধাপটি সম্পন্ন করবেন, তখন আপনার ব্রাউজারে একটি অনুমোদন অনুরোধ গ্রহণ করতে বলা হবে। গ্রহণ করার আগে, নিশ্চিত করুন যে আপনি এমন একটি 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");
    
  3. Create an authorized API client.

    // Create authorized API client.
    DisplayVideo service =
        new DisplayVideo.Builder(credential.getTransport(), credential.getJsonFactory(), credential)
            .setApplicationName("displayvideo-java-installed-app-sample")
            .build();
    

পাইথন

  1. Import the necessary libraries.

    from google_auth_oauthlib.flow import InstalledAppFlow
    from googleapiclient import discovery
    
  2. ক্লায়েন্ট সিক্রেটস ফাইলটি লোড করুন এবং অনুমোদন ক্রেডেনশিয়াল তৈরি করুন।

    আপনি যখন প্রথমবার এই ধাপটি সম্পন্ন করবেন, তখন আপনার ব্রাউজারে একটি অনুমোদন অনুরোধ গ্রহণ করতে বলা হবে। গ্রহণ করার আগে, নিশ্চিত করুন যে আপনি এমন একটি 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()
    
  3. Create an authorized API client.

    # 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 চালাচ্ছেন এবং প্রাসঙ্গিক ওয়েব পেজে রিডাইরেক্ট করার জন্য আপনার ক্রেডেনশিয়াল কনফিগার করেছেন। উদাহরণস্বরূপ, index.php ফাইলের এই কোডটি নিম্নলিখিত কমান্ড এবং প্রমাণীকরণের পরে http://localhost:8000 এ রিডাইরেক্ট করার জন্য কনফিগার করা ক্রেডেনশিয়াল ব্যবহার করে চালানো যেতে পারে:

php -S localhost:8000 -t ./

  1. Download and install the Google API PHP Client.

    The preferred method is using Composer :

    composer require google/apiclient:^2.18.2 google/apiclient-services:=0.396.0

    একবার ইনস্টল হয়ে গেলে, অটোলোডারটি অন্তর্ভুক্ত করতে ভুলবেন না:

    require_once '/path/to/your-project/vendor/autoload.php';
    
  2. Create a Google_Client object.

    $client = new Google_Client();
    
  3. ক্লায়েন্ট সেট আপ করুন, প্রয়োজনে অথেনটিকেশন ইউআরএল-এ রিডাইরেক্ট করুন এবং একটি অ্যাক্সেস টোকেন সংগ্রহ করুন।

    আপনি যখন প্রথমবার এই ধাপটি সম্পন্ন করবেন, তখন আপনার ব্রাউজারে একটি অনুমোদন অনুরোধ গ্রহণ করতে বলা হবে। গ্রহণ করার আগে, নিশ্চিত করুন যে আপনি এমন একটি 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);
    
  4. Display & Video 360 API পরিষেবার জন্য একটি ক্লায়েন্ট তৈরি করুন।

    $service = new Google_Service_DisplayVideo($client);