Method: subscriptions.delete

ยกเลิก ระงับ หรือโอนการสมัครใช้บริการไปยังผู้ให้บริการโดยตรง

คำขอ HTTP

DELETE https://reseller.googleapis.com/apps/reseller/v1/customers/{customerId}/subscriptions/{subscriptionId}

URL ใช้ไวยากรณ์การแปลง gRPC

พารามิเตอร์เส้นทาง

พารามิเตอร์
customerId

string

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

subscriptionId

string

นี่คือพร็อพเพอร์ตี้ที่จำเป็น subscriptionId คือตัวระบุการสมัครใช้บริการและไม่ซ้ำกันสำหรับลูกค้าแต่ละราย เนื่องจาก subscriptionId จะเปลี่ยนแปลงเมื่อมีการอัปเดตการสมัครใช้บริการ เราจึงขอแนะนำว่าอย่าใช้รหัสนี้เป็นคีย์สำหรับข้อมูลถาวร และดู subscriptionId ได้โดยใช้วิธีการดึงข้อมูลการสมัครใช้บริการของตัวแทนจำหน่ายทั้งหมด

พารามิเตอร์การค้นหา

พารามิเตอร์
deletionType

enum (DeletionType)

สตริงการค้นหา deletionType ช่วยให้ยกเลิก ดาวน์เกรด หรือระงับการสมัครใช้บริการได้

เนื้อหาของคำขอ

เนื้อหาของคำขอต้องว่างเปล่า

เนื้อหาการตอบกลับ

ข้อความที่เป็นตัวแทนเนื้อหา HTTP ที่กำหนดเอง ควรใช้เป็นรูปแบบเปย์โหลดที่แสดงเป็น JSON ไม่ได้เท่านั้น เช่น ไฟล์ไบนารีข้อมูล RAW หรือหน้า HTML

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

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

ตัวอย่าง

message GetResourceRequest {
  // A unique request id.
  string requestId = 1;

  // The raw HTTP body is bound to this field.
  google.api.HttpBody http_body = 2;

}

service ResourceService {
  rpc GetResource(GetResourceRequest)
    returns (google.api.HttpBody);
  rpc UpdateResource(google.api.HttpBody)
    returns (google.protobuf.Empty);

}

ตัวอย่างที่ใช้เมธอดสตรีมมิง

service CaldavService {
  rpc GetCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);
  rpc UpdateCalendar(stream google.api.HttpBody)
    returns (stream google.api.HttpBody);

}

การใช้งานประเภทนี้จะเปลี่ยนวิธีจัดการเนื้อหาของคำขอและการตอบกลับเท่านั้น ฟีเจอร์อื่นๆ ทั้งหมดจะยังทำงานเหมือนเดิม

หากสำเร็จ การตอบกลับจะเป็นการตอบกลับ HTTP ทั่วไปที่เมธอดเป็นผู้กำหนดรูปแบบ

การแสดง JSON
{
  "contentType": string,
  "data": string,
  "extensions": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
ช่อง
contentType

string

ค่าส่วนหัว HTTP Content-Type ที่ระบุประเภทเนื้อหาของส่วนเนื้อหา

data

string (bytes format)

เนื้อหาคำขอ/การตอบกลับ HTTP เป็นไบนารีดิบ

สตริงที่เข้ารหัสฐาน 64

extensions[]

object

ข้อมูลเมตาการตอบกลับเฉพาะแอปพลิเคชัน ต้องตั้งค่าในการตอบกลับครั้งแรกสำหรับ API สตรีมมิง

ออบเจ็กต์ที่มีช่องประเภทที่กำหนดเอง ช่องเพิ่มเติม "@type" จะมี URI ที่ระบุประเภท ตัวอย่างเช่น { "id": 1234, "@type": "types.example.com/standard/id" }

ขอบเขตการให้สิทธิ์

ต้องใช้ขอบเขต OAuth ต่อไปนี้

  • https://www.googleapis.com/auth/apps.order

สำหรับข้อมูลเพิ่มเติม โปรดดูที่คู่มือการให้สิทธิ์

DeletionType

Enum
deletion_type_undefined
cancel ยกเลิกการสมัครใช้บริการทันที โดยไม่ได้ใช้กับการสมัครใช้บริการ G Suite
transfer_to_direct

โอนการสมัครใช้บริการไปยัง Google โดยตรง ระบบจะโอนลูกค้าไปยังความสัมพันธ์ด้านการเรียกเก็บเงินโดยตรงกับ Google ทันที และจะมีระยะเวลาสั้นๆ โดยไม่มีการหยุดชะงักของบริการ จากนั้นลูกค้าสามารถเลือกที่จะตั้งค่าการเรียกเก็บเงินโดยตรงกับ Google โดยใช้บัตรเครดิต หรือสามารถโอนไปยังตัวแทนจำหน่ายรายอื่นก็ได้