Google, Ad Manager API के साथ इंटरैक्ट करने के लिए .NET क्लाइंट लाइब्रेरी उपलब्ध कराता है. हमारा सुझाव है कि NuGet के साथ क्लाइंट लाइब्रेरी का इस्तेमाल करें.
शुरू करने के लिए, अपनी पसंद के आईडीई में नया प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट में डिपेंडेंसी जोड़ें. Google, क्लाइंट लाइब्रेरी के आर्टफ़ैक्ट को Google.Ads.AdManager.V1
के तौर पर, NuGet रिपॉज़िटरी में पब्लिश करता है.
पैकेज का रेफ़रंस
<!-- MyProject.csproj -->
<PackageReference Include="Google.Ads.AdManager.V1" Version="1.0.0-beta01" />
.NET सीएलआई
dotnet add package Google.Ads.AdManager.V1 --version 1.0.0-beta01
क्रेडेंशियल कॉन्फ़िगर करना
.NET क्लाइंट लाइब्रेरी, पुष्टि करने के लिए OAuth2 और ऐप्लिकेशन के डिफ़ॉल्ट क्रेडेंशियल (ADC) का इस्तेमाल करती है.
एडीसी, क्रेडेंशियल को इस क्रम में खोजता है:
GOOGLE_APPLICATION_CREDENTIALS
एनवायरमेंट वैरिएबल.- Google Cloud CLI (gcloud CLI) की मदद से सेट अप किए गए उपयोगकर्ता क्रेडेंशियल.
- Google Cloud पर चलने पर, Google Cloud के संसाधन से जुड़ा सेवा खाता.
अपने ADC क्रेडेंशियल बनाने और कॉन्फ़िगर करने के लिए, पुष्टि करना देखें.
अपना पहला अनुरोध करना
हर सेवा में एक 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);
}
}
अन्य तरीकों और संसाधनों के उदाहरणों के लिए, 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);