ไลบรารีของไคลเอ็นต์ .NET

ไลบรารีของไคลเอ็นต์ .NET โฮสต์อยู่ใน GitHub และเผยแพร่เป็นแพ็กเกจ NuGet ไลบรารีนี้มีฟีเจอร์มากมายที่จะช่วยให้คุณใช้ API ได้ ซึ่งรวมถึงการจัดการข้อมูลเข้าสู่ระบบและการสร้างไคลเอ็นต์บริการ Google Ads API ที่ง่ายขึ้น

ไลบรารีรองรับเฟรมเวิร์ก .NET ต่อไปนี้

  • .NET Framework 4.7.2 ขึ้นไป (net472)
  • .NET Standard 2.1 (netstandard2.1)
  • .NET 8.0 (net8.0)

.NET Standard 2.1 เข้ากันได้กับ .NET เวอร์ชันและการติดตั้งใช้งานอื่นๆ อีกหลายเวอร์ชัน ดังนั้นไลบรารีจึงอาจทำงานได้ดีในแพลตฟอร์มอื่นๆ อีกหลายแพลตฟอร์ม อย่างไรก็ตาม เรายังไม่ได้ทดสอบความเข้ากันได้อย่างเป็นทางการ จึงไม่รองรับแพลตฟอร์มเหล่านี้อย่างเป็นทางการ ดูข้อมูลเพิ่มเติมได้ในเอกสารประกอบของ .NET Standard 2.1

ไลบรารี .NET ของ Google Ads API ใช้ Grpc.Net.Client เป็นเลเยอร์การรับส่งข้อมูลเริ่มต้น โดยมี Grpc.Core เป็นทางเลือกสำรองในแพลตฟอร์มที่ไม่รองรับ แม้ว่าคุณจะบังคับให้ใช้ Grpc.Core ได้โดยตั้งค่า UseGrpcCore เป็น true แต่โปรดทราบว่า Grpc.Core เลิกใช้งานแล้วและมีไว้สำหรับการบำรุงรักษาเวอร์ชันเดิมเท่านั้น ดูข้อมูลเพิ่มเติมได้ที่คู่มือการใช้งานเบื้องต้น

การติดตั้ง

ติดตั้งแพ็กเกจ NuGet Google.Ads.GoogleAds ในโปรเจ็กต์โดยใช้เครื่องมือบรรทัดคำสั่ง dotnet ดังนี้

dotnet add package Google.Ads.GoogleAds

หากต้องการโหลดการตั้งค่าการกำหนดค่าจาก appsettings.json, App.config หรือตัวแปรสภาพแวดล้อม ให้ติดตั้งแพ็กเกจ Google.Ads.GoogleAds.Extensions ด้วย

dotnet add package Google.Ads.GoogleAds.Extensions

ทำการเรียก API ครั้งแรก

หากต้องการใช้ Google Ads API คุณต้องทำตามขั้นตอนหลายขั้นตอนเพื่อรับสิทธิ์เข้าถึง API และกำหนดค่าบัญชี Google Ads ทำตามคู่มือเริ่มใช้งานฉบับย่อ ซึ่งจะแนะนำขั้นตอนสำคัญทั้งหมด รวมถึงการตั้งค่าบัญชี Google Ads

การใช้งานพื้นฐาน

เริ่มต้น GoogleAdsConfig และ GoogleAdsClient ด้วยการตั้งค่าการกำหนดค่า ดึงข้อมูล GoogleAdsServiceClient และสตรีมแถวแคมเปญด้วย SearchStream:

using System;
using Google.Ads.Gax.Config;
using Google.Ads.GoogleAds.Config;
using Google.Ads.GoogleAds.Lib;
using Google.Ads.GoogleAds.V26.Errors;
using Google.Ads.GoogleAds.V26.Services;

GoogleAdsConfig config = new GoogleAdsConfig()
{
    OAuth2Mode = OAuth2Flow.APPLICATION,
    OAuth2ClientId = "INSERT_CLIENT_ID.apps.googleusercontent.com",
    OAuth2ClientSecret = "INSERT_CLIENT_SECRET",
    OAuth2RefreshToken = "INSERT_REFRESH_TOKEN",
    LoginCustomerId = "INSERT_LOGIN_CUSTOMER_ID_HERE"
};

GoogleAdsClient client = new GoogleAdsClient(config);
GoogleAdsServiceClient googleAdsService =
    client.GetService(Services.V26.GoogleAdsService);

string customerId = "INSERT_CUSTOMER_ID_HERE";
string query =
    "SELECT campaign.id, campaign.name FROM campaign ORDER BY campaign.id";

try
{
    googleAdsService.SearchStream(
        customerId,
        query,
        delegate (SearchGoogleAdsStreamResponse response)
        {
            foreach (GoogleAdsRow row in response.Results)
            {
                Console.WriteLine(
                    $"Campaign ID {row.Campaign.Id}: {row.Campaign.Name}");
            }
        });
}
catch (GoogleAdsException ex)
{
    Console.WriteLine($"Request ID {ex.RequestId} failed: {ex.Message}");
}

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีใช้ไลบรารีของไคลเอ็นต์ .NET ได้ที่คู่มือการใช้งานเบื้องต้น

การให้สิทธิ์และการตรวจสอบสิทธิ์

ไลบรารีของไคลเอ็นต์ .NET รองรับการตรวจสอบสิทธิ์และการให้สิทธิ์หลายวิธี ซึ่งรวมถึงข้อมูลเข้าสู่ระบบของผู้ใช้ OAuth 2.0 (สำหรับแอปพลิเคชันเดสก์ท็อปและเว็บแอปพลิเคชัน), บัญชีบริการ, ข้อมูลรับรองเริ่มต้นของแอปพลิเคชัน (v24.1.0 ขึ้นไป) และการแทรกข้อมูลเข้าสู่ระบบด้วยตนเอง (v27.0.0 ขึ้นไป) ดูข้อมูลเพิ่มเติมได้ที่คู่มือการให้สิทธิ์และการตรวจสอบสิทธิ์

การกำหนดค่าและการบันทึก

ไลบรารีของไคลเอ็นต์ .NET รองรับตัวเลือกการกำหนดค่าและการบันทึกหลายรายการโดยใช้ออบเจ็กต์รันไทม์ appsettings.json หรือไฟล์ JSON ที่กำหนดเอง ตัวแปรสภาพแวดล้อม หรือไฟล์ App.config ในกรณีที่คุณต้องการแก้ไขลักษณะการทำงานของการบันทึกของไลบรารีของไคลเอ็นต์ โปรดดูคู่มือตัวสกัดกั้น gRPC ที่กำหนดเอง

ยูทิลิตี

ไลบรารีของไคลเอ็นต์ .NET มีคลาสยูทิลิตีเพื่อปรับปรุงความสามารถในการใช้งาน API รวมถึงตัวช่วยอัปโหลดสื่อและวิดีโอ (UploadVideo ใน v27.2.0 ขึ้นไป) ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำต่อไปนี้

ปรับแต่งประสิทธิภาพของแอปพลิเคชัน

ดูคำแนะนำเกี่ยวกับวิธีปรับแต่งประสิทธิภาพของแอปพลิเคชันอย่างละเอียดได้ในคู่มือการปรับแต่งประสิทธิภาพ