การจัดการร้านค้าของคุณ

หมายเหตุ

ทรัพยากร Store พร้อมใช้งานสําหรับผู้เข้าร่วมแบบเบต้าที่ปิดแล้วเท่านั้น สําหรับข้อมูลเกี่ยวกับการเข้าร่วมในโปรแกรมเบต้าแบบปิดหรือโปรแกรมเบต้าแบบเปิด โปรดติดต่อผู้จัดการบัญชีของคุณ

องค์ประกอบการเขียนโปรแกรมและเอกสารของ Store ทั้งหมดอาจเปลี่ยนแปลงได้ระหว่างเบต้า

เมื่อต้องการสร้างร้านค้า ให้ใช้เทมเพลตที่เก็บ POST เนื้อความของ POST เป็นวัตถุ StoreCreate คุณต้องระบุstoreNameเขตข้อมูล , storeDestinationUrlและnotificationEmail ฟิลด์อื่นๆ เป็นตัวเลือก คุณต้อง ได้รับการตรวจสอบและอ้างสิทธิ์ URL ของเว็บไซต์ของคุณก่อนหน้านี้

ต่อไปนี้แสดงตัวอย่างคําขอที่ระบุเฉพาะเขตข้อมูลที่จําเป็น

curl -X POST -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>" -H "Content-Type: application/json" --data "{\"storeName\": \"Contoso Sports\",\"storeUrl\": \"https://contoso.com\",\"notificationEmail\": [\"someone@example.com\"]}"  https://content.api.ads.microsoft.com/v9.1/bmc/stores

ถ้าการร้องขอสําเร็จ เนื้อความของการตอบสนองจะประกอบด้วยวัตถุ Store วัตถุมีเขตข้อมูลที่คุณระบุในคําขอบวกกับเขตข้อมูลทางเลือกทั้งหมดที่มีค่าเริ่มต้น เขตข้อมูล merchantId ประกอบด้วย ID ของร้านค้าใหม่และ storeStatus เขตข้อมูลจะระบุว่าร้านค้าได้รับการอนุมัติหรือไม่

{
  "merchantId": 123456,
  "storeName": "Contoso Sports",
  "storeUrl": "https://contoso.com/",
  "notificationEmail": [
    "someone@example.com"
  ],
  "notificationLanguage": "en-US",
  "isSslCheckout": true,
  "isBlockAggregator": false,
  "storeStatus": {
    "status": "Approved"
  }
}

ถ้าสถานะเป็น ไม่ได้รับอนุมัติ วัตถุ StoreStatus จะมี message เขตข้อมูล ซึ่งระบุสาเหตุที่ร้านค้าไม่ได้รับการอนุมัติ ในตัวอย่างต่อไปนี้ ร้านค้าไม่ได้รับอนุมัติเนื่องจากisSslCheckoutเป็นเท็จ

  "storeStatus": {
    "status": "Disapproved",
    "message": "UnSecuredCheckOut"
  }

ถ้าคําขอ POST ล้มเหลวในการตรวจสอบ เนื้อความของการตอบสนองคือวัตถุ ErrorResponse สําหรับรายการรหัสข้อผิดพลาดที่เป็นไปได้ ให้ดู รหัสข้อผิดพลาด

{
  "errors": [
    {
      "code": "DuplicateStoreNameErr",
      "message": "Another store with the specified store name exists; store names must be unique with Microsoft Merchant Center."
    },
    {
      "code": "NotificationLanguageNotSupportedErr",
      "message": "The market that you specified in the notificationLanguage field is not valid."
    }
  ]
}

การรับรายการร้านค้า

เมื่อต้องการรับรายการของร้านค้าที่ผู้ใช้มีสิทธิ์เข้าถึง ให้ใช้เทมเพลต GET Store ถ้าคุณเป็นหน่วยงาน ให้CustomerIdใส่ ส่วนหัว และCustomerAccountId

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores

การตอบสนองเป็นวัตถุ StoreCollection ฟิลด์storesมีอาร์เรย์ของออบเจ็กต์ Store

{
  "stores": [
    {
      "merchantId": 12345,
      "storeName": "Alpine Ski House",
      "storeUrl": "https://alpineskihouse.com/",
      "notificationEmail": [
        "someone@alpineskihouse.com"],
      "notificationLanguage": "de-De",
      "isSslCheckout": true,
      "isBlockAggregator": false,
      "storeStatus": {
        "status": "Approved"
      }
    },

    . . .

    {
      "merchantId": 67890,
      "storeName": "Fabrikam",
      "storeUrl": "https://fabrikam.com/",
      "notificationEmail": [
        "someone@fabrikam.com"],
      "notificationLanguage": "en-us",
      "isSslCheckout": true,
      "isBlockAggregator": false,
      "storeStatus": {
        "status": "Approved"
      }
    }
  ]
}

การรับร้านค้าเฉพาะ

หากต้องการรับร้านค้าเฉพาะที่ผู้ใช้มีสิทธิ์เข้าถึง ให้ใช้เทมเพลต GET Store ถ้าคุณเป็นหน่วยงาน ให้CustomerIdใส่ ส่วนหัว และCustomerAccountId

curl -H "AuthenticationToken: <access token goes here>" -H "DeveloperToken: <developer token goes here>"  https://content.api.ads.microsoft.com/v9.1/bmc/stores/12345

การตอบสนองเป็นวัตถุ Store

{
  "merchantId": 12345,
  "storeName": "Alpine Ski House",
  "storeUrl": "http://www.alpineskihouse.com",
  "notificationEmail": [
    "someone@alpineskihouse.com"],
  "notificationLanguage": "de-DE",
  "isSslCheckout": true,
  "isBlockAggregator": false,
  "storeStatus": {
    "status": "Approved"
  }
}