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

ينتمي جميع موظّفي الدعم إلى علامة تجارية (نشاط تجاري أو مؤسسة أو مجموعة). قبل أن تتمكّن من إنشاء وكيل، يجب إنشاء علامة تجارية مالكة. إنّ العلامات التجارية هي ميزة تنظيمية بحتة لمساعدتك في تجميع موظّفي الدعم ذات الصلة معًا.

تمّ اقتباس مقتطفات الرموز البرمجية في هذه الصفحة من عيّنات 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.js

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'
}