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

Quản lý danh sách sản phẩm

Hướng dẫn này giải thích cách sử dụng API Nhà phát triển Google Play để tạo và quản lý danh mục sản phẩm cho ứng dụng của bạn trên Play.

Để bán sản phẩm trong ứng dụng thông qua hệ thống thanh toán của Google Play, bạn cần thiết lập một danh mục có tất cả sản phẩm mà bạn muốn người dùng mua. Bạn có thể thực hiện việc này thông qua Play Console hoặc tự động hoá việc quản lý danh mục bằng API Nhà phát triển Google Play. Tính năng tự động hoá có thể giúp đảm bảo danh mục của bạn luôn mới nhất và mở rộng quy mô cho các danh mục lớn mà việc điều phối thủ công là không thực tế. Trong hướng dẫn này, bạn sẽ tìm hiểu cách sử dụng API Nhà phát triển Play để tạo và quản lý danh mục sản phẩm cho ứng dụng Play. Hãy xem hướng dẫn Chuẩn bị sẵn sàng để biết cách thiết lập API Nhà phát triển Google Play cho việc tích hợp phần phụ trợ.

API Quản lý danh mục

Để đọc về các loại sản phẩm mà bạn có thể bán thông qua hệ thống thanh toán của Google Play, hãy đọc bài viết Tìm hiểu các loại sản phẩm trong ứng dụng và những điều cần lưu ý về danh mục. Google cung cấp hai nhóm API chính để quản lý danh mục trên Play, tương ứng với hai danh mục sản phẩm chính:

Sản phẩm tính phí một lần
Sản phẩm đăng ký

Sản phẩm tính phí một lần

Điểm cuối inappproducts cho phép bạn quản lý các sản phẩm tính phí một lần từ phần phụ trợ. Điều này bao gồm việc tạo, cập nhật và xoá sản phẩm, cũng như quản lý giá và tình trạng còn hàng. Tuỳ thuộc vào cách bạn xử lý giao dịch mua sản phẩm tính phí một lần, bạn sẽ lập mô hình sản phẩm tiêu dùng (có thể mua nhiều lần tuỳ ý) hoặc quyền sử dụng vĩnh viễn (cùng một người dùng không thể mua hai lần). Bạn có thể quyết định xem sản phẩm tính phí một lần nào là sản phẩm tiêu dùng.

Sản phẩm đăng ký

Điểm cuối monetization.subscriptions giúp bạn quản lý các sản phẩm thuê bao từ phần phụ trợ dành cho nhà phát triển. Bạn có thể thực hiện các thao tác như tạo, cập nhật và xoá gói thuê bao, hoặc kiểm soát tình trạng còn hàng và giá theo khu vực của các gói thuê bao đó. Ngoài điểm cuối monetization.subscriptions, chúng tôi cũng cung cấp monetization.subscriptions.basePlans và monetization.subscriptions.basePlans.offers để quản lý gói cơ bản và ưu đãi của gói thuê bao tương ứng.

Phương thức hàng loạt

Các điểm cuối inappproducts và monetization.subscriptions cung cấp một số phương thức theo lô cho phép truy xuất hoặc quản lý tối đa 100 thực thể trong cùng một ứng dụng cùng một lúc.

Các phương thức xử lý hàng loạt, khi được sử dụng với độ trễ được bật, sẽ hỗ trợ thông lượng cao hơn và đặc biệt hữu ích cho các nhà phát triển danh mục lớn để tạo danh mục ban đầu hoặc điều chỉnh danh mục.

Độ trễ truyền tải nội dung cập nhật so với thông lượng

Sau khi yêu cầu tạo hoặc sửa đổi sản phẩm hoàn tất, người dùng cuối có thể không thấy ngay các thay đổi trên thiết bị của họ do độ trễ trong quá trình xử lý mạng hoặc phần phụ trợ. Theo mặc định, tất cả yêu cầu sửa đổi sản phẩm đều nhạy cảm với độ trễ. Điều này có nghĩa là các bản cập nhật này được tối ưu hoá để truyền tải nhanh qua các hệ thống phụ trợ, thường phản ánh trên thiết bị của người dùng cuối trong vòng vài phút. Tuy nhiên, có giới hạn hằng giờ về số lượng yêu cầu sửa đổi như vậy. Trong trường hợp cần tạo hoặc cập nhật nhiều sản phẩm (ví dụ: trong quá trình tạo danh mục lớn ban đầu), bạn có thể sử dụng các phương thức hàng loạt với trường latencyTolerance được đặt thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. Điều này sẽ làm tăng đáng kể thông lượng cập nhật. Các bản cập nhật có thể chịu được độ trễ sẽ mất đến 24 giờ để truyền đến thiết bị của người dùng cuối.

Cấu hình hạn mức

Bạn cần lưu ý một số hạn mức về hạn mức khi sử dụng API Nhà phát triển Play để quản lý danh mục sản phẩm:

API Nhà phát triển Google Play có giới hạn mặc định là 200.000 truy vấn mỗi ngày. Giới hạn hạn mức này áp dụng cho tổng mức sử dụng ở tất cả các điểm cuối, bao gồm cả API quản lý danh mục.
Các điểm cuối sửa đổi sản phẩm cũng thực thi giới hạn 7.200 truy vấn mỗi giờ. Đây là một giới hạn duy nhất đối với cả sản phẩm mua một lần và gói thuê bao, cũng như đối với tất cả yêu cầu sửa đổi, bao gồm cả việc tạo, cập nhật, kích hoạt và xoá. Các lệnh gọi phương thức sửa đổi hàng loạt được tính là một truy vấn cho hạn mức này, bất kể số lượng yêu cầu riêng lẻ có trong đó hay độ nhạy của độ trễ.
Các nội dung sửa đổi nhạy cảm với độ trễ cũng có hạn mức là 7.200 nội dung sửa đổi mỗi giờ. Đối với các phương thức hàng loạt, mỗi yêu cầu sửa đổi lồng nhau sẽ được tính riêng cho mục đích của hạn mức này. Hạn mức này chỉ có ý nghĩa thực tế đối với người dùng API hàng loạt thực hiện các bản cập nhật nhạy cảm về độ trễ, vì trong các trường hợp khác, hạn mức 2 sẽ hết trước hoặc cùng lúc với hạn mức này.

Sau đây là một số ví dụ minh hoạ để hiểu cách sử dụng hạn mức của các yêu cầu khác nhau:

Một yêu cầu get để tìm nạp một mục sẽ tiêu thụ 1 mã thông báo của hạn mức 1 và không có mã thông báo nào của hạn mức 2 và 3 (vì các hạn mức này chỉ liên quan đến các điểm cuối sửa đổi).
Yêu cầu get theo lô để tìm nạp tối đa 100 mục cũng sẽ sử dụng 1 mã thông báo của hạn mức 1 và không sử dụng mã thông báo của hạn mức 2 và 3.
Một yêu cầu modification cho một mặt hàng sẽ tiêu thụ 1 mã thông báo của hạn mức 1, 1 mã thông báo của hạn mức 2. Nếu yêu cầu nhạy cảm với độ trễ, thì yêu cầu đó cũng sẽ tiêu thụ 1 mã thông báo của hạn mức 3. Vì hạn mức C có cùng giới hạn với hạn mức 2, nên hạn mức này không có tác động thực tế đối với những người dùng chỉ sử dụng một phương thức sửa đổi.
Một yêu cầu modification theo lô cho 100 mục có thể chịu được độ trễ sẽ sử dụng 1 mã thông báo của hạn mức 1, 1 mã thông báo của hạn mức 2. Chế độ thiết lập hạn mức này sẽ cho phép bạn có đủ khoảng đệm để cập nhật danh mục, nhưng nếu thuật toán của bạn không nhận biết được hạn mức này và vượt quá tỷ lệ này, thì bạn có thể gặp lỗi cho mỗi lệnh gọi bổ sung.
Một yêu cầu modification hàng loạt cho 100 mục nhạy cảm với độ trễ sẽ tiêu thụ 1 mã thông báo của hạn mức 1, 1 mã thông báo của hạn mức 2 và 100 mã thông báo của hạn mức 3.

Đề xuất về cách sử dụng API Quản lý danh mục

Bằng cách tuân thủ các nguyên tắc này, bạn có thể tối ưu hoá hoạt động tương tác với API, đảm bảo trải nghiệm quản lý danh mục suôn sẻ và hiệu quả.

Theo dõi mức sử dụng

Bạn nên lưu ý đến các quy trình sử dụng nhiều. Ví dụ: khi bắt đầu tích hợp, các điểm cuối quản lý danh mục có nhiều khả năng sẽ sử dụng nhiều hạn mức hơn để tạo danh mục ban đầu đầy đủ. Điều này có thể ảnh hưởng đến việc sử dụng điểm cuối khác trong môi trường sản xuất như API trạng thái mua hàng nếu bạn sắp đạt đến hạn mức sử dụng tổng thể. Bạn cần theo dõi mức sử dụng hạn mức để đảm bảo rằng bạn không vượt quá hạn mức API. Có một số cách để theo dõi mức sử dụng. Ví dụ: bạn có thể sử dụng trang tổng quan về hạn mức API của Google Cloud hoặc bất kỳ công cụ theo dõi API nào khác của bên thứ ba hoặc nội bộ mà bạn chọn.

Tối ưu hoá việc sử dụng hạn mức API

Bạn nên tối ưu hoá mức sử dụng tốc độ để giảm thiểu khả năng xảy ra lỗi API. Để triển khai hiệu quả, bạn nên:

Chọn chiến lược quản lý danh mục phù hợp. Sau khi hiểu rõ hạn mức API, bạn cần chọn chiến lược phù hợp cho ứng dụng của mình để đạt được mục tiêu quản lý danh mục một cách hiệu quả.
Chỉ thực hiện số lượng lệnh gọi tối thiểu cần thiết để phản ánh các thay đổi của bạn.
Không gửi các lệnh gọi sửa đổi thừa hoặc không cần thiết đến API. Điều này có thể yêu cầu bạn lưu giữ nhật ký thay đổi trong danh mục phụ trợ.
Không vượt quá giới hạn 7.200 truy vấn mỗi giờ đối với việc sửa đổi sản phẩm. Bạn có thể muốn tạo các quy trình đồng bộ hoá yêu cầu bạn thực hiện nhiều sửa đổi sản phẩm trong một khoảng thời gian ngắn (ví dụ: tạo danh mục ban đầu). Nếu bạn dự kiến các quy trình này sẽ vượt quá giới hạn hằng giờ, hãy triển khai các hoạt động chờ nếu cần để giảm mức sử dụng xuống mức an toàn. Cân nhắc sử dụng các phương thức xử lý hàng loạt với các bản cập nhật có thể chịu được độ trễ để đạt được thông lượng cao hơn.
Chủ động chuẩn bị để mở rộng quy mô. Khi ứng dụng phát triển, bạn có thể cần mở rộng mức sử dụng API và nhiều điểm cuối. Hãy đọc tài liệu về hạn mức API Nhà phát triển Google Play để biết thông tin chi tiết về cách tăng hạn mức khi bạn sắp đạt đến mức sử dụng tối đa.
Lên lịch xử lý các quy trình nặng một cách có chiến lược. Hãy cố gắng lên lịch cho các quy trình danh mục tốn nhiều tài nguyên vào thời điểm sử dụng cao điểm, ví dụ: bạn có thể tránh chạy quy trình đồng bộ hoá danh mục đầy đủ trong thời gian bán hàng cao điểm trong tuần.

Thêm logic xử lý lỗi hạn mức

Bất kể bạn xây dựng logic quản lý danh mục hiệu quả đến mức nào, bạn cũng nên làm cho logic đó có khả năng thích ứng với các hạn mức hạn mức không mong muốn, vì hạn mức hằng ngày được chia sẻ giữa các điểm cuối dùng trong các mô-đun độc lập của quá trình tích hợp. Hãy đảm bảo bạn đưa các lỗi điều tiết hạn mức vào quá trình xử lý lỗi và triển khai thời gian chờ thích hợp. Mỗi lệnh gọi đến API Nhà phát triển Google Play sẽ tạo ra một phản hồi. Trong trường hợp lệnh gọi không thành công, bạn sẽ nhận được một phản hồi không thành công bao gồm mã trạng thái phản hồi HTTP và đối tượng errors, cung cấp thêm thông tin chi tiết về miền lỗi và thông báo gỡ lỗi. Ví dụ: nếu vượt quá hạn mức hằng ngày, bạn có thể gặp lỗi tương tự như sau:

{
  "code" : 403,
  "errors" : [ {
    "domain" : "usageLimits",
    "message" : "Daily Limit Exceeded. The quota will be reset at midnight Pacific Time (PT). You may monitor your quota usage and adjust limits in the API
  Console: https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxxx",
  "reason" : "dailyLimitExceeded",
  "extendedHelp" : "https://console.developers.google.com/apis/api/androidpublisher.googleapis.com/quotas?project=xxxxxx"
  } ],
}

Triển khai tính năng quản lý danh mục

Nhà phát triển sử dụng các điểm cuối phát hành sản phẩm của API Nhà phát triển Google Play để đồng bộ hoá danh mục giữa phần phụ trợ và Google Play. Việc đảm bảo rằng danh mục trên Google Play luôn cập nhật thông tin mới nhất của danh mục phụ trợ sẽ mang lại lợi ích để tạo trải nghiệm tốt hơn cho người dùng. Ví dụ:

Bạn có thể tham khảo toàn bộ danh sách ưu đãi hiện có và quản lý các thẻ ưu đãi và gói cơ bản để ảnh hưởng đến điều kiện của riêng bạn và logic hiển thị ưu đãi.
Bạn có thể kiểm tra các mức giá và thông tin chi tiết về sản phẩm mà người dùng đang thấy trên các nền tảng, đồng thời đảm bảo rằng các thông tin này nhất quán.
Bạn sẽ có thông tin chi tiết về sản phẩm trong phần phụ trợ khi xử lý các giao dịch mua mới mà không cần tăng độ trễ và nguy cơ thất bại bằng cách thực hiện thêm các lệnh gọi đến API Nhà phát triển Google Play trong các luồng quan trọng của người dùng.

Có một số giới hạn và điều cần cân nhắc mà bạn cần lưu ý khi tạo danh mục sản phẩm trên Google Play. Sau khi hiểu rõ các giới hạn này và biết mình muốn sắp xếp danh mục như thế nào, đã đến lúc bạn quyết định chiến lược đồng bộ hoá.

Chiến lược đồng bộ hoá danh mục

Các điểm cuối phát hành của API Nhà phát triển Google Play cho phép bạn cập nhật danh mục khi có thay đổi. Đôi khi, bạn có thể cần áp dụng phương pháp cập nhật định kỳ, trong đó bạn gửi một loạt thay đổi trong cùng một quy trình. Mỗi phương pháp lại yêu cầu các lựa chọn thiết kế khác nhau. Mỗi chiến lược đồng bộ hoá sẽ phù hợp với một số trường hợp sử dụng hơn so với các chiến lược khác và bạn có thể có một bộ nhu cầu đòi hỏi cả hai, tuỳ thuộc vào tình huống. Đôi khi, bạn có thể muốn cập nhật sản phẩm ngay khi nhận thấy một thay đổi mới, chẳng hạn như để xử lý một nội dung cập nhật sản phẩm khẩn cấp (tức là cần sửa giá không chính xác càng sớm càng tốt). Trong những trường hợp khác, bạn có thể sử dụng tính năng đồng bộ hoá trong nền định kỳ để đảm bảo rằng phần phụ trợ và danh mục trên Play luôn nhất quán. Hãy đọc một số trường hợp sử dụng phổ biến mà bạn có thể muốn triển khai các chiến lược quản lý danh mục này.

Thời điểm gửi nội dung cập nhật khi danh mục nội dung cục bộ thay đổi

Lý tưởng nhất là bạn nên cập nhật ngay khi có bất kỳ thay đổi nào đối với danh mục sản phẩm của phần phụ trợ để giảm thiểu sự khác biệt.

Bạn nên chọn loại bản cập nhật này khi:

Bạn phải đảm bảo rằng sản phẩm của mình luôn được cập nhật.
Bạn cần thực hiện một vài thay đổi đối với sản phẩm mỗi ngày.
Bạn cần cập nhật những sản phẩm đã được sản xuất và đang được bán.

Phương pháp này đơn giản hơn để triển khai và cho phép bạn đồng bộ hoá danh mục với khoảng thời gian chênh lệch số lượng ít nhất.

Trường hợp nên sử dụng bản cập nhật định kỳ

Các bản cập nhật định kỳ được chạy không đồng bộ với phiên bản sản phẩm trên phần phụ trợ của bạn. Đây là một lựa chọn phù hợp khi:

Bạn không cần phải đảm bảo rằng sản phẩm của mình được cập nhật trong thời gian ngắn.
Bạn cần lên kế hoạch cho các quy trình cập nhật hàng loạt hoặc hoà giải.
Bạn đã có một Hệ thống quản lý nội dung hoặc danh mục để xử lý các sản phẩm kỹ thuật số và hệ thống đó liên tục cập nhật danh mục

Trong trường hợp danh mục lớn, hãy cân nhắc sử dụng các phương thức theo lô có bản cập nhật có thể chịu được độ trễ để đạt được thông lượng tối đa.

Lưu ý: Mặc dù bạn có thể gửi nội dung cập nhật cho danh mục sản phẩm trên Google Play ngay khi có thay đổi, nhưng điều này không có nghĩa là người dùng sẽ thấy được nội dung cập nhật ngay trong ứng dụng. Quá trình này vẫn có thể bị trễ do độ trễ trong quá trình xử lý mạng hoặc phụ trợ. Tương tự, mặc dù các bản cập nhật định kỳ được thực hiện với một số độ trễ, nhưng bạn vẫn có thể thiết kế để cập nhật thường xuyên danh mục của mình nếu cần, giúp người dùng có thể sử dụng các thay đổi của bạn với độ trễ tương tự như các bản cập nhật theo yêu cầu. Ngoài ra, trường latencyTolerance trong các phương thức xử lý hàng loạt cho phép bạn chọn giữa việc tối ưu hoá để truyền tải nhanh nội dung cập nhật hoặc tăng thông lượng. Cuối cùng, bạn nên chọn một trong hai lựa chọn này dựa trên các yêu cầu và giới hạn cụ thể của mình.

Tạo danh mục sản phẩm

Nếu có một danh mục lớn cần tải lên Google Play, bạn nên tự động hoá quá trình tải ban đầu. Loại quy trình nặng này hoạt động hiệu quả nhất nếu bạn tuân theo chiến lược định kỳ kết hợp với các phương thức xử lý hàng loạt có thể chịu được độ trễ.

Tạo sản phẩm tính phí một lần

Để tạo danh mục lớn sản phẩm tính phí một lần ban đầu, bạn nên sử dụng phương thức inappproducts.batchUpdate với trường allowMissing được đặt thành true và trường latencyTolerance được đặt thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. Việc này sẽ giúp giảm thiểu thời gian tạo danh mục trong hạn mức.

Đối với các danh mục nhỏ hơn, bạn có thể sử dụng phương thức inapp_products.insert. Ngoài ra, bạn có thể sử dụng phương thức inappproducts.update với tham số allowMissing như mô tả trong phần Cập nhật sản phẩm. Phương pháp này có lợi ích là không cần tập lệnh của bạn phải có trạng thái và có thể khởi động lại từ đầu nếu có bất kỳ lỗi nào.

Tạo sản phẩm thuê bao

Để tạo danh mục lớn cho gói thuê bao ban đầu, bạn nên sử dụng phương thức monetization.subscriptions.batchUpdate với trường allowMissing được đặt thành true và trường latencyTolerance được đặt thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT. Việc này sẽ giúp giảm thiểu thời gian tạo danh mục trong hạn mức.

Đối với các danh mục gói thuê bao nhỏ hơn, API Nhà phát triển Play cung cấp phương thức monetization.subscriptions.create. Ngoài ra, bạn có thể tạo gói thuê bao bằng phương thức monetization.subscriptions.patch với tham số allowMissing như mô tả trong phần Cập nhật sản phẩm.

Tất cả các phương thức trước đó đều tạo gói thuê bao cùng với gói cơ bản (được cung cấp trong đối tượng Gói thuê bao). Các gói cơ bản này ban đầu sẽ ở trạng thái không hoạt động. Để quản lý trạng thái của gói cơ bản, bạn có thể sử dụng điểm cuối monetization.subscriptions.basePlans, bao gồm cả việc kích hoạt gói cơ bản để cung cấp gói đó cho người dùng mua. Ngoài ra, điểm cuối monetization.subscriptions.basePlans.offers cho phép bạn tạo và quản lý các ưu đãi.

Thông tin cập nhật về sản phẩm

Các phương thức sau đây cho phép bạn sửa đổi hiệu quả các sản phẩm hiện có, đảm bảo sản phẩm của bạn phù hợp với các mức điều chỉnh mới nhất.

Cập nhật sản phẩm tính phí một lần

Bạn có thể sử dụng 3 phương thức để cập nhật các sản phẩm tính phí một lần hiện có.

inappproducts.patch: Điểm cuối của bản vá được dùng để cập nhật một phần tài nguyên. Điều này có nghĩa là bạn có thể cập nhật các trường cụ thể mà bạn chỉ định trong phần nội dung yêu cầu. Điểm cuối bản vá thường được dùng khi bạn chỉ cần cập nhật một vài trường của tài nguyên.
inappproducts.update: Điểm cuối cập nhật được dùng để cập nhật toàn bộ tài nguyên. Điều này có nghĩa là bạn sẽ cần gửi toàn bộ đối tượng tài nguyên trong phần nội dung yêu cầu. Điểm cuối cập nhật thường được dùng khi bạn cần cập nhật tất cả các trường trong một tài nguyên. Khi tham số allowMissing được đặt thành true và mã sản phẩm được cung cấp chưa tồn tại, điểm cuối sẽ chèn sản phẩm thay vì không thực hiện được.
inappproducts.batchUpdate: Đây là phiên bản hàng loạt của điểm cuối cập nhật, cho phép bạn sửa đổi nhiều sản phẩm bằng một truy vấn duy nhất. Sử dụng cùng với trường latencyTolerance được đặt thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT để đạt được thông lượng cao hơn.

Cập nhật sản phẩm thuê bao

Để cập nhật các gói thuê bao hiện có, bạn có thể sử dụng phương thức monetization.subscriptions.patch. Phương thức này sẽ lấy các tham số bắt buộc sau:

packageName: Tên gói của ứng dụng mà gói thuê bao thuộc về.
productId: Mã sản phẩm duy nhất của gói thuê bao.
regionsVersion: Phiên bản cấu hình theo khu vực.

Trừ phi bạn đang tạo một gói thuê bao mới bằng cách sử dụng thông số allowMissing, bạn phải cung cấp thông số updateMask. Tham số này là một danh sách các trường mà bạn muốn cập nhật, được phân tách bằng dấu phẩy.

Ví dụ: nếu chỉ muốn cập nhật trang thông tin của một sản phẩm thuê bao, bạn sẽ chỉ định trường listings cho thông số updateMask.

Bạn có thể sử dụng monetization.subscriptions.batchUpdate để cập nhật nhiều gói thuê bao cùng một lúc. Sử dụng cùng với trường latencyTolerance được đặt thành PRODUCT_UPDATE_LATENCY_TOLERANCE_LATENCY_TOLERANT để đạt được thông lượng cao hơn.

Để kích hoạt, vô hiệu hoá, xoá gói cơ bản hoặc di chuyển người đăng ký sang phiên bản giá gói cơ bản mới nhất, hãy sử dụng điểm cuối monetization.subscriptions.basePlans.

Ngoài ra, bạn có thể cập nhật ưu đãi của gói cơ bản bằng phương thức monetization.subscriptions.basePlans.offers.patch.

Điều chỉnh danh mục

Cho dù bạn chọn cập nhật danh mục trên Google Play mỗi khi danh mục của phần phụ trợ thay đổi hay định kỳ, nếu bạn có hệ thống quản lý danh mục hoặc cơ sở dữ liệu bên ngoài danh mục của Google Play, thì có thể có những trường hợp danh mục đó không đồng bộ với danh mục trên cấu hình ứng dụng của bạn trên Play. Nguyên nhân có thể là do các thay đổi khẩn cấp theo cách thủ công đối với danh mục trong Console, sự cố ngừng hoạt động của hệ thống quản lý danh mục hoặc có thể là do bạn đã mất dữ liệu mới nhất.

Bạn có thể xây dựng quy trình điều chỉnh danh mục để tránh tình trạng chênh lệch kéo dài.

Cân nhắc về hệ thống so sánh

Bạn nên xây dựng một hệ thống so sánh để phát hiện sự không nhất quán và điều chỉnh hai hệ thống. Sau đây là một số điều cần cân nhắc khi xây dựng hệ thống so sánh để giúp đồng bộ hoá danh mục:

Tìm hiểu các mô hình dữ liệu: Bước đầu tiên là tìm hiểu các mô hình dữ liệu của CMS dành cho nhà phát triển và API Nhà phát triển Google Play. Điều này bao gồm việc biết các loại dữ liệu được lưu trữ trong mỗi hệ thống và cách các phần tử dữ liệu liên kết với nhau.
Xác định quy tắc so sánh: Sau khi hiểu rõ các mô hình dữ liệu, bạn cần xác định quy tắc so sánh. Các quy tắc này sẽ xác định cách so sánh dữ liệu trong hai hệ thống. Ví dụ: bạn có thể muốn so khớp mã sản phẩm và so sánh các thuộc tính chính của gói thuê bao với các gói cơ bản và ưu đãi liên quan.
Triển khai thuật toán so sánh: Sau khi xác định các quy tắc so sánh, bạn cần triển khai thuật toán so sánh. Thuật toán này sẽ lấy dữ liệu từ hai hệ thống và so sánh dữ liệu đó theo các quy tắc mà bạn đã xác định. Để lấy dữ liệu danh mục từ Google Play, bạn có thể sử dụng các phương thức inappproducts.list, inappproducts.batchGet, monetization.subscriptions.list và monetization.subscriptions.batchGet.
Tạo báo cáo so sánh: Thuật toán so sánh sẽ tạo báo cáo so sánh. Báo cáo này sẽ cho thấy sự khác biệt giữa cả hai hệ thống.
Điều chỉnh sự khác biệt: Sau khi tạo báo cáo chênh lệch, bạn cần giải quyết sự khác biệt. Việc này có thể liên quan đến việc cập nhật dữ liệu trong CMS hoặc cập nhật dữ liệu phía Google Play bằng các điểm cuối quản lý danh mục API dành cho nhà phát triển, tuỳ thuộc vào cách bạn thường cập nhật danh mục. Để điều chỉnh những sản phẩm không đồng bộ, hãy sử dụng các điểm cuối cập nhật như mô tả trong phần Cập nhật sản phẩm.

Ngừng sử dụng sản phẩm

API Nhà phát triển Google Play cung cấp một số phương thức để hỗ trợ nhà phát triển ngừng sử dụng sản phẩm: inappproducts.delete và inappproducts.batchDelete cho sản phẩm tính phí một lần và monetization.subscriptions.delete cho gói thuê bao. Bạn có thể cần ngừng sử dụng một sản phẩm trong nhiều trường hợp, chẳng hạn như:

Tạo do nhầm lẫn.
Ngừng cung cấp một tính năng hoặc dịch vụ.

Bạn nên đưa việc ngừng sử dụng sản phẩm vào chiến lược quản lý danh mục.

Ngừng sử dụng sản phẩm tính phí một lần

Để xoá sản phẩm tính phí một lần bằng API Nhà phát triển Google Play, bạn cần sử dụng phương thức inappproducts.delete hoặc inappproducts.batchDelete.

Ngừng sử dụng sản phẩm thuê bao

Bạn có thể xoá gói thuê bao bằng phương thức monetization.subscriptions.delete. Bạn không thể xoá gói thuê bao sau khi kích hoạt ít nhất một gói cơ bản.