إدارة العلامات التجارية

ينتمي جميع العملاء إلى علامة تجارية (نشاط تجاري أو مؤسسة أو مجموعة). قبل إنشاء وكيل، يجب إنشاء علامة تجارية مالكة. تُستخدم العلامات التجارية لأغراض تنظيمية فقط لمساعدتك في تجميع الوكلاء المرتبطين معًا.

تم أخذ مقتطفات التعليمات البرمجية في هذه الصفحة من عيّنات Java وعيّنات Node.js.

إنشاء علامة تجارية

يمكنك إنشاء علامة تجارية جديدة. لمزيد من التفاصيل، راجِع brands وbrands.create.

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.createBrand('My new brand').then((response) => {
	console.log('The new brand is:');
	console.log(response.data);
}).catch((err) => {
	console.log(err);
});

Java

String displayName = flags.getOrDefault("brand_name", "Test brand: " + now.getSecond());
Brand brand = api.createBrand(displayName);
logger.info("New brand id: " + brand.getName());

يعرض هذا الرمز اسم العلامة التجارية الجديد (displayName) ومعرّفًا فريدًا (name) تم تعيينه للعلامة التجارية:

{
  name: 'brands/17456b6b-65dc-4e35-b128-fd3047664ddf',
  displayName: 'My new brand'
}

استرداد علامة تجارية

يمكنك استرداد معلومات حول علامة تجارية باستخدام المعرّف الفريد الخاص بها (name). لمزيد من التفاصيل، اطّلِع على brands.get.

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.getBrand(brandId).then((response) => {
  console.log('Brand details are:');
  console.log(response.data);
}).catch((err) => {
  console.log(err);
});

Java

Brand brand = api.getBrand(brandId);
logger.info("Brand: " + brand);

يعرض هذا الرمز معلومات العلامة التجارية:

{
  name: 'brands/17456b6b-65dc-4e35-b128-fd3047664ddf',
  displayName: 'My new brand'
}

قائمة العلامات التجارية

يمكنك استرداد قائمة بجميع العلامات التجارية التي أنشأتها. لمزيد من التفاصيل، يُرجى الاطّلاع على brands.list.

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper.listBrands().then((response) => {
  console.log('Current brands available are:');
  console.log(response.data);
}).catch((err) => {
  console.log(err);
});

Java

List<Brand> brands = api.listBrands().stream().sorted(Comparator.comparing(Brand::getName))
  .collect(Collectors.toList());
logger.info(String.format("Found %d brands", brands.size()));
for (Brand brand : brands) {
  logger.info(String.format("Brand [%s]: '%s'", brand.getName(), brand.getDisplayName()));
}

يعرض هذا الرمز قائمة بجميع علاماتك التجارية:

{
  brands: [
    {
      name: 'brands/1deb6297-8a57-474a-a02c-48529a3de0a0',
      displayName: 'My brand'
    },
    {
      name: 'brands/3b607982-8c06-467a-96b8-020ddc26ac83',
      displayName: 'My second brand'
    },
    {
      name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017',
      displayName: 'My thrd brand'
    }
  ]
}

إعادة تسمية علامة تجارية

يمكنك تغيير الاسم المعروض الخاص بالعلامة التجارية. لمزيد من التفاصيل، يُرجى الاطّلاع على brands.patch.

يمكن تغيير الاسم المعروض للعلامة التجارية باستخدام العملية patch:

Node.js

const businessCommunicationsApiHelper =
  require('@google/rbm-businesscommunications');

const privateKey =
  require('../../resources/businesscommunications-service-account-credentials.json');

businessCommunicationsApiHelper.initBusinessCommunucationsApi(privateKey);

businessCommunicationsApiHelper
  .patchBrand(brand.name, 'My brand new name').then((response) => {
    console.log(response.data);
});

يعرض هذا الرمز معلومات العلامة التجارية المعدَّلة:

{
  name: 'brands/40bd963f-ff92-425c-b273-8f0892d2d017',
  displayName: 'My brands new name'
}