পটভূমি
সুরক্ষিত ব্যক্তিগত চিত্র বৈশিষ্ট্যটি আপনাকে পাসগুলিতে এমন চিত্রগুলি সংজ্ঞায়িত করতে দেয় যা সর্বজনীনভাবে মুখোমুখি URL থেকে অ্যাক্সেসযোগ্য হওয়ার প্রয়োজন হয় না (নিয়মিত চিত্রগুলি পাসগুলিতে সঠিকভাবে রেন্ডার করার জন্য একটি প্রয়োজনীয়তা)। আপনি একটি চিত্র আপলোড করতে Wallet API ব্যবহার করেন এবং একটি শনাক্তকারী পান যা Wallet পাস অবজেক্টে সেই চিত্রটি উল্লেখ করতে ব্যবহার করা যেতে পারে।
নিম্নলিখিত পাস প্রকারগুলি সমর্থিত;
- ইভেন্ট টিকিট
- বোর্ডিং পাস
- ট্রানজিট পাস
- অফার কার্ড
- উপহার কার্ড
- লয়্যালটি পাস
- জেনেরিক পাস
বৈশিষ্ট্যের উদাহরণ
 |
| নিরাপদ ব্যক্তিগত ছবি ব্যবহার করে সদস্যপদ কার্ড |
ব্যবহারের ক্ষেত্রে
সুরক্ষিত ব্যক্তিগত ছবিগুলি এমন ছবি ব্যবহার করতে সক্ষম করে যা সর্বজনীনভাবে অ্যাক্সেসযোগ্য হওয়ার প্রয়োজন হয় না এবং তাই প্রোফাইল ছবির মতো জিনিসের জন্য ব্যবহার করা যেতে পারে। এটি নিম্নলিখিত ক্ষেত্রে ব্যবহারের সুযোগ দেয়, তবে সীমাবদ্ধ নয়;
- বার্ষিক সদস্যপদ পাস
- বিজনেস কার্ড
- ট্রানজিট পাস
দ্রষ্টব্য: নিরাপদ ব্যক্তিগত ছবিগুলি সরকার কর্তৃক জারি করা পরিচয়পত্র হিসেবে পাস উপস্থাপনের জন্য ব্যবহার করা যাবে না এবং গ্রহণযোগ্য ব্যবহার নীতিতে সংজ্ঞায়িত অতিরিক্ত নির্দেশিকাও অন্তর্ভুক্ত থাকবে।
ওয়ালেট ফিচার ব্যবহার করার সময় কিছু বিবেচ্য বিষয়
- জেনেরিক প্রাইভেট পাসের সাথে ব্যবহার করা যাবে না
- শুধুমাত্র পাস অবজেক্টগুলিতে যোগ করা যেতে পারে (ক্লাস নয়)
- শুধুমাত্র একটি একক বস্তুর সাথে ব্যবহার করা যেতে পারে
- শুধুমাত্র ImageModuleData এর সাথে ব্যবহার করা যেতে পারে (অন্যান্য ছবি নয়, যেমন লোগো এবং প্রশস্ত হেডার লোগো)
উন্নয়নাধীন বৈশিষ্ট্য
- ওয়েব সাপোর্ট
- হিরো ইমেজের উপর ব্যক্তিগত ছবি
ইন্টিগ্রেশন ধাপ
- একটি
privateImageIdপেতে Google Wallet API ব্যবহার করে আপনার ব্যক্তিগত ছবি আপলোড করুন। - পাস অবজেক্টে একটি ছবি যোগ করুন (উদাহরণস্বরূপ,
ImageModuleData)। ছবিতেsourceUriফিল্ড সেট করার পরিবর্তে, আপনি পূর্ববর্তী ধাপ থেকে প্রাপ্ত মান সহprivateImageIdফিল্ড সেট করবেন।
সিকোয়েন্স ডায়াগ্রাম
 |
| নিরাপদ ব্যক্তিগত ছবির ক্রম |
উদাহরণ কোড
ছবিটি আপলোড করুন
String issuerId = "12345"; String keyFilePath = "/path/to/key.json"; GoogleCredential credential = GoogleCredential.fromStream(new FileInputStream(keyFilePath)) .createScoped(Arrays.asList("https://www.googleapis.com/auth/wallet_object.issuer")); HttpTransport httpTransport = GoogleNetHttpTransport.newTrustedTransport(); // Prepare request to upload image String contentType = "image/jpeg"; // MIME type of image String imageFilePath = "/path/to/image.jpg"; HttpContent content = new ByteArrayContent( contentType, ByteStreams.toByteArray(new FileInputStream(imageFilePath))); String url = String.format( "https://walletobjects.googleapis.com/upload/walletobjects/v1/privateContent/%s/uploadPrivateImage", issuerId); // Make request to upload image HttpResponse response = httpTransport .createRequestFactory(credential) .buildPostRequest(new GenericUrl(url), content) .execute(); // Get privateImageId from response Gson gson = new Gson(); JsonObject jsonObject = gson.fromJson(response.parseAsString(), JsonObject.class); String privateImageId = jsonObject.get("privateImageId").getAsString();
পাস অবজেক্টে প্রাইভেট ইমেজ ব্যবহার করুন
// Build GenericObject with privateImageId in ImageModuleData (also adding an optional TextModuleData) Image image = new Image().setPrivateImageId(privateImageId); ImageModuleData imageModuleData = new ImageModuleData().setId("imageId").setMainImage(image); TextModuleData textModuleData = new TextModuleData().setId("textId").setHeader("Card holder").setBody("John Doe"); GenericObject genericObject = new GenericObject() .setId(issuerId + ".objectId") // class must be inserted before inserting object .setClassId(issuerId + ".classId") .setCardTitle("Business name") .setHeader("My membership card") .setImageModulesData(Arrays.asList(imageModuleData)) .setTextModulesData(Arrays.asList(textModuleData)); // Insert GenericObject (or can use in JWT without inserting ahead of time) Walletobjects service = new Walletobjects.Builder(httpTransport, GsonFactory.getDefaultInstance(), credential) .setApplicationName("My Application") .build(); service.genericobject().insert(genericObject).execute();
সামনে ছবিটি দেখানোর জন্য পাসটি আপডেট করুন।
আপনি যেকোনো imageModulesDatafield-এ নিরাপদ ব্যক্তিগত ছবি ব্যবহার করতে পারেন। টেমপ্লেট ওভাররাইড ব্যবহার করে কার্ডের সামনের দিকে ছবি স্থাপন করার জন্য imageModulesData ফিল্ড কীভাবে ব্যবহার করবেন তার একটি উদাহরণ নিচে দেওয়া হল। টেমপ্লেট ওভাররাইড সহ একটি ক্লাস সন্নিবেশ করার একটি উদাহরণ এখানে দেওয়া হল:
CardTemplateOverride cardTemplateOverride =
new CardTemplateOverride()
.setCardRowTemplateInfos(
Arrays.asList(
new CardRowTemplateInfo()
.setTwoItems(
new CardRowTwoItems()
// The ids chosen here must be set on the object's TextModuleData and ImageModuleData
.setStartItem(
createTemplateItem("object.textModulesData['textId']"))
.setEndItem(
createTemplateItem("object.imageModulesData['imageId']")))));
GenericClass genericClass =
new GenericClass()
.setId(issuerId + ".classId")
.setClassTemplateInfo(
new ClassTemplateInfo().setCardTemplateOverride(cardTemplateOverride));
service.genericclass().insert(genericClass);
...
private static TemplateItem createTemplateItem(String fieldPath) {
return new TemplateItem()
.setFirstValue(
new FieldSelector()
.setFields(Arrays.asList(new FieldReference().setFieldPath(fieldPath))));
}ব্যতিক্রম পরিচালনা
Wallet FeatureAPI-এর ভুল ব্যবহারের ফলে সম্ভাব্য ত্রুটি ঘটতে পারে যার মধ্যে অন্তর্ভুক্ত থাকতে পারে;
| বার্তা | কারণ |
|---|---|
| ছবিতে source_uri এবং private_image_id দুটোই থাকতে পারে না। | ইস্যুকারী একটি একক ছবিতে source_uri এবং private_image_id সেট করার চেষ্টা করেছে, যা অনুমোদিত নয়। |
| ইস্যুকারী %s এর জন্য %s আইডি সহ ব্যক্তিগত ছবি খুঁজে পাওয়া যায়নি। | একটি বস্তুর উপর একটি অস্তিত্বহীন ব্যক্তিগত চিত্র আইডি সেট করা |
| %s অবজেক্টের সাথে ইতিমধ্যেই ব্যবহৃত হওয়ায়, ইস্যুকারী %s এর জন্য %s আইডি সহ ব্যক্তিগত ছবি %s অবজেক্টে যোগ করা যায়নি। একটি ব্যক্তিগত ছবি শুধুমাত্র একটি অবজেক্টের সাথে ব্যবহার করা যেতে পারে। | একাধিক বস্তুতে একই ব্যক্তিগত ছবি ব্যবহার করার চেষ্টা করা হচ্ছে। একাধিক বস্তুর সাথে একই ব্যক্তিগত ছবি ব্যবহার করার জন্য, এটি পুনরায় আপলোড করতে হবে এবং আপনি একটি নতুন ব্যক্তিগত ছবি আইডি পাবেন, যা দ্বিতীয় বস্তুর সাথে ব্যবহার করা যেতে পারে। |