# Push Kit-Service-SampleCode-Timeline-Java

**Repository Path**: harmonyos_samples/push-kit-service-sample-code-timeline-java

## Basic Information

- **Project Name**: Push Kit-Service-SampleCode-Timeline-Java
- **Description**: 本示例基于Java语言实现了向元服务推送基于账号的服务动态消息。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2024-08-31
- **Last Updated**: 2025-12-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Server-Side Sample Code for Sending Service Updates
- This demo provides sample code for sending service updates messages for an atomic service based on Java.
## Supported Java Versions
Java 8+
## Getting Started
### Download
Download the demo and open it in the IDE.
### Preparations
1. Apply for the service updates message permission of atomic services.
   - Sending service updates messages is a business-to-customer (B2C) message capability provided for developers. With this capability, you will be able to send real-time updates to users regarding key nodes of their orders, keeping them informed of their order status.\
     You can enable the service updates message permission by referring to Pushing an Account-based Service Updates Message.

2. Obtain the service account credential file.
   - Create the key file of a service account.\
     Create and download the key file of a service account to call Push Kit APIs on [API Console](https://developer.huawei.com/consumer/cn/console/overview) of HUAWEI Developers. For details, please refer to [API Console Operation Guide - Creating a Service Account Key](https://developer.huawei.com/consumer/en/doc/start/api-0000001062522591#section2080424916353).\
     The following is an example of the service account key file (with key information anonymized):
     ~~~json
     {
       "project_id": "*****",
       "key_id": "*****",
       "private_key": "-----BEGIN PRIVATE KEY-----\n**********************************==\n-----END PRIVATE KEY-----\n",
       "sub_account": "*****",
       "auth_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/authorize",
       "token_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/token",
       "auth_provider_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/certs",
       "client_cert_uri": "https://oauth-login.cloud.huawei.com/oauth2/v3/x509?client_id="
     }
     ~~~
3. Set service updates parameters.
   - [projectId]: project ID. To obtain the value, sign in to [AppGallery Connect](https://developer.huawei.com/consumer/en/service/josp/agc/index.html#/), click **Development and services**, click the desired project, and go to **Project settings**.
   - [Authorization]: JWT string. For details about how to obtain the value, please refer to [Authorization](https://developer.huawei.com/consumer/en/doc/harmonyos-references/push-scenariozed-api-request-struct#section20573634202313). You can also generate the string using the service account credential file based on the demo.
   - [appId]: app Id of the atomic service. To obtain the app ID, sign in to [AppGallery Connect](https://developer.huawei.com/consumer/en/service/josp/agc/index.html#/), click **Apps/Atomic services**, select an atomic service, and query the app ID of the atomic service under **Basic information** on the **App information** page.
   - [toOpenId]: OpenID of the recipient. Use the OpenId reported by the client or request [user information](https://developer.huawei.com/consumer/en/doc/harmonyos-references/account-api-get-user-info) from Account Kit.
   - [sceneId]: scenario ID.
   - [subSceneId]: sub-scenario ID.
   - [content]: status specified in a service updates message.
### Running the Demo
Replace the following items in the [service account credential file](./src/main/resources/service_account.json): project ID, appId(atomic service app ID), scenario ID, and sub-scenario ID in the [configuration file](./src/main/resources/config.json), as well as the code, OpenId of the recipient, and message body in the [project](./src/main/java/com/huawei/serviceTimeline/TakeawaysExamples.java). Then run the main method to send a service updates message.