.NET

Google, Ad Manager API के साथ इंटरैक्ट करने के लिए .NET क्लाइंट लाइब्रेरी उपलब्ध कराता है. हमारा सुझाव है कि आप NuGet के साथ क्लाइंट लाइब्रेरी का इस्तेमाल करें.

शुरू करने के लिए, अपनी पसंद के IDE में एक नया प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट में डिपेंडेंसी जोड़ें. Google, क्लाइंट लाइब्रेरी के आर्टफ़ैक्ट को NuGet डेटाबेस में Google.Ads.AdManager.V1 के तौर पर पब्लिश करता है.

<!-- MyProject.csproj -->
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />

dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01

क्रेडेंशियल कॉन्फ़िगर करना

.NET क्लाइंट लाइब्रेरी, पुष्टि करने के लिए OAuth2 और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (एडीसी) का इस्तेमाल करती है.

एडीसी, क्रेडेंशियल को इन जगहों पर इस क्रम में खोजता है:

1. GOOGLE_APPLICATION_CREDENTIALS एनवायरमेंट वैरिएबल.
2. Google Cloud CLI (gcloud CLI) के ज़रिए सेट अप किए गए उपयोगकर्ता क्रेडेंशियल.
3. Google Cloud पर चलने पर, Google Cloud संसाधन से जुड़ा सेवा खाता.

एडीसी क्रेडेंशियल बनाने और कॉन्फ़िगर करने के लिए, Authentication देखें.

पहला अनुरोध करना

हर सेवा में एक ServiceClient ऑब्जेक्ट होता है. इसमें REST के हर तरीके के लिए, सिंक्रोनस और असिंक्रोनस, दोनों तरीके होते हैं. नीचे दिए गए उदाहरण में, Network को सिंक्रोनस तरीके से पढ़ा गया है. सभी इकाइयों की पहचान, संसाधन के नाम से की जाती है. इसमें इकाई का टाइप और संख्यात्मक पहचानकर्ता शामिल होता है.

    using Google.Ads.AdManager.V1;

    public sealed partial class GeneratedNetworkServiceClientSnippets
    {
        public void GetNetwork()
        {
            // Create client
            NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
            // Initialize request argument(s)
            string name = "networks/[NETWORK_CODE]";
            // Make the request
            Network response = networkServiceClient.GetNetwork(name);
        }
    }
NetworkServiceClient.GetNetworkSnippet.g.cs

अन्य तरीकों और संसाधनों के उदाहरण देखने के लिए, GitHub रिपॉज़िटरी googleapis/google-cloud-dotnet देखें.

गड़बड़ियों को ठीक करना

Ad Manager API से जुड़ी सभी गड़बड़ियां, .NET क्लाइंट लाइब्रेरी में Grpc.Core.RpcException टाइप की होती हैं.

गड़बड़ियों में एक यूनीक request_id शामिल होता है. इसे सहायता टीम को दिया जा सकता है, ताकि समस्या हल करने में मदद मिल सके. यहां दिए गए उदाहरण में, एचटीटीपी स्टेटस, गड़बड़ी का मैसेज, और request_id को निकाला गया है.

using Google.Ads.AdManager.V1;
using Google.Api.Gax.Grpc;
using Google.Rpc;
using Grpc.Core;

try
{
    NetworkServiceClient networkServiceClient = NetworkServiceClient.Create();
    Network network = networkServiceClient.GetNetwork("networks/[NETWORK_CODE]");
}
catch(RpcException e)
{
    // HTTP Status code
    StatusCode statusCode = e.Status.StatusCode;
    // Error message
    string errorMessage = e.Status.Detail;
    // Unique request identifier.
    RequestInfo requestInfo = e.GetStatusDetail<RequestInfo>();
    string requestId = requestInfo?.RequestId ?? "Unexpected null request identifier";
}

संसाधन के नाम बनाना

क्लाइंट लाइब्रेरी, आईडी से संसाधन के नाम बनाने के लिए हेल्पर क्लास उपलब्ध कराती है. इन्हें सीधे तौर पर सेवा के तरीकों में पास किया जा सकता है.

//  Represents a resource name in the format:
//  "networks/{networkCode}/orders/{orderId}"
OrderName name = OrderName.FromNetworkCodeOrder("123", "456");
Order response = orderServiceClient.GetOrder(name);

प्रॉक्सी सेटिंग कॉन्फ़िगर करें

.NET क्लाइंट लाइब्रेरी, HttpClient.DefaultProxy प्रॉपर्टी का पालन करती है. इसमें एनवायरमेंट वैरिएबल HTTP_PROXY और HTTPS_PROXY से प्रॉक्सी सेट करना भी शामिल है. ज़्यादा जानकारी के लिए, HttpClient.DefaultProxy प्रॉपर्टी देखें.