Trang này được dịch bởi Cloud Translation API.

Bắt đầu sử dụng Merchant API

Trang này giải thích cách bạn có thể tạo tài khoản Merchant Center và tải một sản phẩm mẫu lên bằng Merchant API.

Trước khi bắt đầu

Bật Merchant API trong dự án Google Cloud.

Nếu bạn sử dụng chế độ tích hợp API trong Apps Script bằng Dịch vụ nội dung mua sắm, thì chế độ này sẽ tạo một dự án Google Cloud mặc định và tự động bật dịch vụ Merchant API. Tuy nhiên, bạn vẫn cần hoàn tất quy trình đăng ký Nhà phát triển một lần trước khi sử dụng Merchant API. Để biết thêm thông tin, hãy xem bài viết Sử dụng Dịch vụ Merchant API trong Apps Script.

Truy cập vào Google Cloud

Tạo tài khoản

Để sử dụng Merchant API, bạn phải có một tài khoản Merchant Center. Để tạo một tài khoản, hãy xem bài viết Bắt đầu sử dụng Merchant Center.

Chuyển đến Merchant Center

Đăng ký làm nhà phát triển

Để sử dụng Merchant API, bạn phải tạo mối liên kết giữa dự án Google Cloud và tài khoản Merchant Center chính. Bạn phải đăng ký một lần cho mỗi dự án Google Cloud mà bạn sử dụng với Merchant API.

Việc đăng ký làm nhà phát triển sẽ giúp bạn thực hiện 2 việc:

Thao tác này sẽ liên kết dự án Google Cloud với tài khoản Merchant Center chính của bạn, thiết lập một mối kết nối chính thức.
Thao tác này sẽ tạo một người liên hệ kỹ thuật bằng cách chỉ định vai trò API_DEVELOPER cho một người dùng trong tài khoản Merchant Center. Nhờ đó, Google có thể gửi cho bạn các thông tin cập nhật quan trọng về API, chẳng hạn như thông báo về dịch vụ và thông tin về các tính năng mới.

Đăng ký dự án của bạn trên Google Cloud

Để đăng ký, hãy gọi phương thức developerRegistration.registerGcp. Lệnh gọi này sẽ liên kết dự án Google Cloud mà bạn dùng để thực hiện lệnh gọi với tài khoản Merchant Center mà bạn chỉ định trong yêu cầu.

Trong nội dung yêu cầu, bạn phải cung cấp địa chỉ email của nhà phát triển để dùng làm người liên hệ kỹ thuật. Địa chỉ này phải được liên kết với một Tài khoản Google (tài khoản Google Workspace hoặc tài khoản Gmail), ví dụ: sampleuser@gmail.com. Bạn không thể sử dụng tài khoản dịch vụ vì đây là tài khoản không phải của con người, được thiết kế để truy cập theo chương trình chứ không phải để giao tiếp với nhà phát triển.

Nếu địa chỉ email đó đã thuộc về một người dùng trong tài khoản Merchant Center, thì người dùng đó sẽ được cấp vai trò API_DEVELOPER.
Nếu địa chỉ email không thuộc về một người dùng hiện có, thì một lời mời sẽ được gửi đến địa chỉ đó. Người nhận phải chấp nhận lời mời thì mới được thêm làm người dùng mới có vai trò API_DEVELOPER.

Sau đây là ví dụ về yêu cầu:

POST https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/developerRegistration:registerGcp

{
  "developerEmail": "{DEVELOPER_EMAIL}"
}

Một lệnh gọi thành công sẽ trả về tài nguyên DeveloperRegistration, xác nhận mối liên kết giữa dự án và tài khoản của bạn.

{
  "name": "accounts/{ACCOUNT_ID}/developerRegistration",
  "gcpIds": [
    "123456789012345"
  ]
}

Quản lý thông tin liên hệ và quyền của nhà phát triển

Sau khi đăng ký, bạn nên thêm nhiều nhà phát triển và cấp cho họ các quyền truy cập bổ sung.

Cấp thêm quyền

Bạn phải có vai trò API_DEVELOPER để nhận thông báo quan trọng, nhưng vai trò này có rất ít quyền trong Merchant Center. Để cho phép người dùng này thực hiện các lệnh gọi API khác hoặc quản lý chế độ cài đặt trong giao diện người dùng Merchant Center, bạn cần cấp cho họ các vai trò bổ sung, chẳng hạn như STANDARD hoặc ADMIN. Để biết thêm thông tin, hãy xem phần Các loại quyền truy cập.

Bạn có thể cập nhật quyền truy cập của người dùng bằng phương thức accounts.users.patch.

Ví dụ sau đây cho thấy cách cập nhật người dùng để cấp cho họ cả vai trò ADMIN và API_DEVELOPER. Việc này cho phép họ quản lý hoàn toàn tài khoản và họ cũng sẽ nhận được thông tin liên lạc liên quan đến API.

PATCH https://merchantapi.googleapis.com/accounts/v1/accounts/{ACCOUNT_ID}/users/{DEVELOPER_EMAIL}?update_mask=access_rights

{
  "access_rights": [
    "ADMIN",
    "API_DEVELOPER"
  ]
}

Thêm nhà phát triển dự phòng

Để tránh bị gián đoạn quyền truy cập API nếu người liên hệ chính của nhà phát triển rời khỏi tổ chức của bạn, bạn nên thêm ít nhất một nhà phát triển dự phòng.

Bạn có thể thêm người dùng bằng phương thức accounts.users.create hoặc cập nhật người dùng hiện có bằng phương thức accounts.users.patch. Bạn nên cấp cho người dùng này cả vai trò ADMIN và API_DEVELOPER.

Tạo một nguồn dữ liệu sản phẩm chính

Để chèn một sản phẩm, bạn cần có một nguồn dữ liệu sản phẩm chính. Yêu cầu sau đây cho biết cách tạo một nguồn dữ liệu mà bạn có thể dùng để chèn một sản phẩm vào tài khoản của mình:

POST https://merchantapi.googleapis.com/datasources/v1/accounts/{ACCOUNT_ID}/dataSources HTTP/1.1

{
  "primaryProductDataSource": {
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "feedLabel": "US"
  },
  "name": "primary-data-source",
  "displayName": "Primary Products Data Source"
}

Thay thế {ACCOUNT_ID} bằng mã nhận dạng của tài khoản Merchant Center mà bạn đã tạo.

Sau khi chạy thành công yêu cầu này, bạn sẽ thấy phản hồi sau:

{
  "name": "accounts/{ACCOUNT_ID}/dataSources/{DATASOURCE_ID}",
  "dataSourceId": "{DATASOURCE_ID}",
  "displayName": "Primary Products Data Source",
  "primaryProductDataSource": {
    "feedLabel": "US",
    "contentLanguage": "en",
    "countries": [
      "US"
    ],
    "defaultRule": {
      "takeFromDataSources": [
        {
          "self": true
        }
      ]
    }
  },
  "input": "API"
}

Sao chép giá trị của trường name. Bạn sẽ cần mã này để chèn một sản phẩm.

Bạn có thể xem nguồn dữ liệu này trong giao diện người dùng của Merchant Center. Để biết thêm thông tin, hãy xem bài viết Cách tìm thẻ Nguồn dữ liệu.

Chèn sản phẩm

Để chèn một sản phẩm mẫu vào tài khoản của bạn, hãy chạy yêu cầu sau:

POST https://merchantapi.googleapis.com/products/v1/accounts/{ACCOUNT_ID}/productInputs:insert?dataSource={DATASOURCE_NAME} HTTP/1.1

{
  "contentLanguage": "en",
  "feedLabel": "US",
  "name": "Red T-shirt",
  "attributes": {
    "gender": "Male",
    "brand": "New brand"
  },
  "offerId": "tshirt-123"
}

Thay thế {DATASOURCE_NAME} bằng giá trị mà bạn đã sao chép trước đó.