Element: <subscriptionquery-message>

Valid parent

<bpds>

Valid children

<address>, <status>

The content provider sends the <subscriptionquery-message> element to the PPG to determine the statuses of a specified set of PINs or tokens, or to determine what PINs or tokens have a specified status.

You can use a subscription query message to reconcile your recorded subscription information with the PPG's subscription information. To make sure the two are consistent with each other, you should reconcile the subscription information once a month.

There are two forms of subscription query request:
  • A Requested-PIN or token query returns all PIN or token values with a specified status of active or suspended.
  • A Supplied-PIN or token query lists the PINs or tokens for which subscription information is needed; a single subscription query is limited to 10,000 PINs or tokens.

To avoid overloading servers, you can send this message only 100 times in 10 minutes. Each call can contain up to 10,000 addresses, which means that up to 1,000,000 PINs or tokens can be synchronized in 10 minutes.

Attributes

Attribute

Value

Descriptions

pushservice-id

unique_id

This attribute specifies a string that uniquely identifies the push service.



Was this information helpful? Send us your comments.