แชร์ผ่าน

การดําเนินการรับบริการ GetGeoLocationsFileUrl - การจัดการแคมเปญ

  • บทความ

รับ URL ชั่วคราวที่คุณสามารถใช้เพื่อดาวน์โหลดไฟล์ที่ประกอบด้วยตัวระบุสําหรับตําแหน่งที่ตั้งทางภูมิศาสตร์ที่คุณสามารถตั้งเป้าหมายหรือแยกออกได้

สําหรับรายละเอียดเกี่ยวกับเนื้อหาของไฟล์ ให้ดู รหัสที่ตั้งทางภูมิศาสตร์

ร้องขอองค์ประกอบ

วัตถุ GetGeoLocationsFileUrlRequest จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการร้องขอการดําเนินการบริการ องค์ประกอบต้องอยู่ในลําดับเดียวกับที่แสดงใน Request SOAP

หมายเหตุ

เว้นแต่ระบุไว้เป็นอย่างอื่นด้านล่าง จําเป็นต้องระบุองค์ประกอบคําขอทั้งหมด

ร้องขอองค์ประกอบเนื้อความ

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
CompressionType กําหนดชนิดการบีบอัดที่เป็นไปได้สําหรับไฟล์ที่จะดาวน์โหลด

รูปแบบการบีบอัดที่ได้รับการสนับสนุนในขณะนี้คือ GZip

องค์ประกอบการร้องขอนี้เป็นทางเลือก ถ้าไม่มีการส่งผ่านค่า API จะส่งกลับไฟล์ที่ไม่มีการบีบอัดต่อไป		 CompressionType
LanguageLocale ภาษาและตําแหน่งที่ตั้งของชื่อที่แสดงตําแหน่งที่ตั้งทางภูมิศาสตร์ ค่าภาษาที่รองรับคือ zh-Hant (จีนดั้งเดิม), en (อังกฤษ), fr (ฝรั่งเศส), de (เยอรมัน), it (อิตาลี), ja-JP (ญี่ปุ่น), pt-BR (โปรตุเกสบราซิล) และ es (สเปน) สาย อักขระ
เวอร์ชัน เวอร์ชันของไฟล์ตําแหน่งที่ตั้งที่คุณต้องการดาวน์โหลด

ในขณะนี้ เฉพาะเวอร์ชันที่ได้รับการสนับสนุนคือ 2.0		 สาย อักขระ

องค์ประกอบส่วนหัวของคําขอ

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
AuthenticationToken โทเค็นการเข้าถึง OAuth ที่แสดงข้อมูลประจําตัวของผู้ใช้ที่มีสิทธิ์เข้าถึงบัญชี Microsoft Advertising

สําหรับข้อมูลเพิ่มเติม ดูการรับรองความถูกต้องด้วย OAuth		 สาย อักขระ
CustomerAccountId ตัวระบุบัญชีโฆษณาที่เป็นเจ้าของหรือเชื่อมโยงกับเอนทิตีในคําขอ องค์ประกอบส่วนหัวนี้ต้องมีค่าเดียวกันกับองค์ประกอบเนื้อความ AccountId เมื่อต้องการทั้งสองอย่าง องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ

สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ		 สาย อักขระ
CustomerId ตัวระบุบัญชีผู้จัดการ (ลูกค้า) ที่ผู้ใช้กําลังเข้าถึงหรือดําเนินการ ผู้ใช้สามารถเข้าถึงบัญชีผู้จัดการได้หลายบัญชี องค์ประกอบนี้จําเป็นสําหรับการดําเนินการบริการส่วนใหญ่ และเป็นแนวทางปฏิบัติที่ดีที่สุดที่คุณควรตั้งค่าไว้เสมอ

สําหรับข้อมูลเพิ่มเติม ดูรับบัญชีและรหัสลูกค้าของคุณ		 สาย อักขระ
DeveloperToken โทเค็นนักพัฒนาที่ใช้เพื่อเข้าถึง Bing Ads API

สําหรับข้อมูลเพิ่มเติม ดูรับโทเค็นนักพัฒนา		 สาย อักขระ
รหัส ผ่าน องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ สาย อักขระ
ชื่อ องค์ประกอบนี้สงวนไว้สําหรับการใช้ภายในและจะถูกเอาออกจากเวอร์ชันในอนาคตของ API คุณต้องใช้องค์ประกอบ AuthenticationToken เพื่อตั้งค่าข้อมูลประจําตัวของผู้ใช้ สาย อักขระ

องค์ประกอบการตอบสนอง

วัตถุ GetGeoLocationsFileUrlResponse จะกําหนดองค์ประกอบ เนื้อความ และ ส่วนหัว ของการตอบสนองการดําเนินการบริการ องค์ประกอบจะถูกส่งกลับตามลําดับเดียวกับที่แสดงใน Response SOAP

องค์ประกอบเนื้อความการตอบสนอง

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
FileUrl URL ของไฟล์ที่คุณสามารถใช้เพื่อดาวน์โหลดข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์สําหรับเวอร์ชัน ภาษา และตําแหน่งที่ตั้งที่คุณร้องขอ

ก่อนที่คุณจะดาวน์โหลดไฟล์ ให้ตรวจสอบว่าวันที่และเวลาขององค์ประกอบ LastModifiedTimeUtc ช้ากว่าวันที่และเวลาของการดาวน์โหลดก่อนหน้านี้ของคุณหรือไม่ คุณควรดาวน์โหลดไฟล์ถ้าจําเป็นเท่านั้น		 สาย อักขระ
FileUrlExpiryTimeUtc วันที่และเวลาที่ URL ของไฟล์ที่ระบุจะหมดอายุ

หากคุณไม่ได้ดาวน์โหลดไฟล์ก่อนเวลาหมดอายุคุณสามารถเรียกใช้การดําเนินการอีกครั้งเพื่อร้องขอ URL ไฟล์ใหม่ คุณอาจสังเกตเห็นว่า URL ถูกตั้งค่าให้หมดอายุ 15 นาทีนับจากเวลาที่การดําเนินการนี้เสร็จสมบูรณ์ อย่างไรก็ตาม คุณไม่ควรขึ้นอยู่กับระยะเวลาคงที่ การเรียกไปยังการดําเนินการนี้ในอนาคตอาจส่งผลให้เวลาหมดอายุสั้นลงหรือยาวขึ้น

ค่าอยู่ในเวลามาตรฐานสากล (UTC) ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML		 Datetime
LastModifiedTimeUtc วันที่และเวลาที่มีการอัปเดตข้อมูลตําแหน่งที่ตั้งทางภูมิศาสตร์สําหรับเวอร์ชันที่ระบุ ภาษา และตําแหน่งที่ตั้งล่าสุด

แนวทางปฏิบัติที่ดีที่สุดคือ คุณควรจัดเก็บวันที่และเวลานี้ และไปข้างหน้าดาวน์โหลดไฟล์ก็ต่อเมื่อค่านี้ได้รับการอัปเดตเป็นวันที่และเวลาในภายหลังเท่านั้น

ค่าอยู่ในเวลามาตรฐานสากล (UTC) ค่าวันที่และเวลาแสดงวันที่และเวลาที่เซิร์ฟเวอร์ ไม่ใช่ไคลเอ็นต์ สําหรับข้อมูลเกี่ยวกับรูปแบบของวันที่และเวลา ดูรายการ dateTime ในชนิดข้อมูล Primitive XML		 Datetime

องค์ประกอบส่วนหัวการตอบสนอง

องค์ ประกอบ คำอธิบาย ชนิดข้อมูล
TrackingId ตัวระบุของรายการบันทึกที่ประกอบด้วยรายละเอียดของการเรียกใช้ API สาย อักขระ

ร้องขอ SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดง ลําดับ ขององค์ประกอบ เนื้อความ และ ส่วนหัว สําหรับคําขอ SOAP สําหรับชนิดที่สนับสนุนที่คุณสามารถใช้กับการดําเนินการบริการนี้ โปรดดูการอ้างอิง องค์ประกอบเนื้อความคําขอ ด้านบน

<s:Envelope xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <Action mustUnderstand="1">GetGeoLocationsFileUrl</Action>
    <AuthenticationToken i:nil="false">ValueHere</AuthenticationToken>
    <CustomerAccountId i:nil="false">ValueHere</CustomerAccountId>
    <CustomerId i:nil="false">ValueHere</CustomerId>
    <DeveloperToken i:nil="false">ValueHere</DeveloperToken>
  </s:Header>
  <s:Body>
    <GetGeoLocationsFileUrlRequest xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <Version i:nil="false">ValueHere</Version>
      <LanguageLocale i:nil="false">ValueHere</LanguageLocale>
      <CompressionType i:nil="false">ValueHere</CompressionType>
    </GetGeoLocationsFileUrlRequest>
  </s:Body>
</s:Envelope>

Response SOAP

เทมเพลตนี้ถูกสร้างขึ้นโดยเครื่องมือเพื่อแสดงลําดับขององค์ประกอบ เนื้อ ความและ ส่วนหัว สําหรับการตอบสนอง SOAP

<s:Envelope xmlns:s="http://schemas.xmlsoap.org/soap/envelope/">
  <s:Header xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
    <TrackingId d3p1:nil="false" xmlns:d3p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</TrackingId>
  </s:Header>
  <s:Body>
    <GetGeoLocationsFileUrlResponse xmlns="https://bingads.microsoft.com/CampaignManagement/v13">
      <FileUrl d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</FileUrl>
      <FileUrlExpiryTimeUtc d4p1:nil="false" xmlns:d4p1="http://www.w3.org/2001/XMLSchema-instance">ValueHere</FileUrlExpiryTimeUtc>
      <LastModifiedTimeUtc>ValueHere</LastModifiedTimeUtc>
    </GetGeoLocationsFileUrlResponse>
  </s:Body>
</s:Envelope>

ไวยากรณ์โค้ด

ไวยากรณ์ตัวอย่างสามารถใช้กับ Bing Ads SDKs ได้ ดู ตัวอย่างโค้ด API ของโฆษณา Bing สําหรับตัวอย่างเพิ่มเติม

public async Task<GetGeoLocationsFileUrlResponse> GetGeoLocationsFileUrlAsync(
	string version,
	string languageLocale,
	CompressionType? compressionType)
{
	var request = new GetGeoLocationsFileUrlRequest
	{
		Version = version,
		LanguageLocale = languageLocale,
		CompressionType = compressionType
	};

	return (await CampaignManagementService.CallAsync((s, r) => s.GetGeoLocationsFileUrlAsync(r), request));
}

static GetGeoLocationsFileUrlResponse getGeoLocationsFileUrl(
	java.lang.String version,
	java.lang.String languageLocale,
	CompressionType compressionType) throws RemoteException, Exception
{
	GetGeoLocationsFileUrlRequest request = new GetGeoLocationsFileUrlRequest();

	request.setVersion(version);
	request.setLanguageLocale(languageLocale);
	request.setCompressionType(compressionType);

	return CampaignManagementService.getService().getGeoLocationsFileUrl(request);
}

static function GetGeoLocationsFileUrl(
	$version,
	$languageLocale,
	$compressionType)
{

	$GLOBALS['Proxy'] = $GLOBALS['CampaignManagementProxy'];

	$request = new GetGeoLocationsFileUrlRequest();

	$request->Version = $version;
	$request->LanguageLocale = $languageLocale;
	$request->CompressionType = $compressionType;

	return $GLOBALS['CampaignManagementProxy']->GetService()->GetGeoLocationsFileUrl($request);
}

response=campaignmanagement_service.GetGeoLocationsFileUrl(
	Version=Version,
	LanguageLocale=LanguageLocale,
	CompressionType=CompressionType)

ข้อกําหนด

บริการ: การส่งเสริมการขายการจัดการบริการ.svc v13
Namespace: https://bingads.microsoft.com/CampaignManagement/v13