التشغيل السريع: البحث عن معلومات عامل التشغيل لرقم هاتف باستخدام Azure Communication Services

مقالة
04/04/2024

هام

هذه الميزة من Azure Communication Services قيد المعاينة حاليا.

يتم توفير واجهات برمجة التطبيقات وSDKs للمعاينة دون اتفاقية على مستوى الخدمة. نوصي بعدم استخدامها لأحمال عمل الإنتاج. قد لا تكون بعض الميزات مدعومة، أو قد تكون لها قدرات مقيدة.

لمزيد من المعلومات، راجع شروط الاستخدام التكميلية لمعاينات Microsoft Azure.

ابدأ باستخدام مكتبة عميل أرقام الهاتف ل JavaScript للبحث عن معلومات المشغل لأرقام الهواتف، والتي يمكن استخدامها لتحديد ما إذا كان سيتم الاتصال برقم الهاتف هذا وكيفية الاتصال به. اتبع هذه الخطوات لتثبيت الحزمة والبحث عن معلومات المشغل حول رقم هاتف.

إشعار

ابحث عن رمز بدء التشغيل السريع هذا في GitHub

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
Node.js إصدارات Active LTS (الدعم طويل الأجل) وصيانة LTS (8.11.1 و10.14.1 الموصى بها).
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد Communication Services

التحقق من المتطلبات الأساسية

في نافذة طرفية أو نافذة أوامر، قم بتشغيل node --version الأمر للتحقق من تثبيت Node.js.

الإعداد

لإعداد بيئة لإرسال استعلامات البحث، اتبع الخطوات الواردة في الأقسام التالية.

إنشاء تطبيق Node.js جديد

في نافذة طرفية أو نافذة أوامر، أنشئ دليلا جديدا لتطبيقك وانتقل إليه.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

قم بتشغيل npm init -y لإنشاء ملف package.json بالإعدادات الافتراضية.

npm init -y

إنشاء ملف يسمى number-lookup-quickstart.js في جذر الدليل الذي قمت بإنشائه. أضف القصاصة البرمجية التالية إليه:

async function main() {
    // quickstart code will go here
}

main();

تثبيت الحزمة

استخدم الأمر npm installلتثبيت مكتبة عميل أرقام هواتف خدمات الاتصال في Azure لـ JavaScript.

npm install @azure/communication-phone-numbers@1.3.0-beta.4 --save

يضيف الخيار --saveالمكتبة كعنصر تبعية في ملفpackage.json الخاص بك.

أمثلة على التعليمات البرمجية

مصادقة العميل

استيراد الهاتف NumbersClient من مكتبة العميل وإنشاء مثيل له مع سلسلة الاتصال، والتي يمكن الحصول عليها من مورد Azure Communication Services في مدخل Microsoft Azure. COMMUNICATION_SERVICES_CONNECTION_STRING يوصى باستخدام متغير بيئة لتجنب وضع سلسلة الاتصال في نص عادي داخل التعليمات البرمجية الخاصة بك. تعرف على كيفية إدارة سلسلة اتصال الموارد خاصتك.

أضف التعليمات البرمجية التالية إلى أعلى number-lookup-quickstart.js:

const { PhoneNumbersClient } = require('@azure/communication-phone-numbers');

// This code retrieves your connection string from an environment variable
const connectionString = process.env['COMMUNICATION_SERVICES_CONNECTION_STRING'];

// Instantiate the phone numbers client
const phoneNumbersClient = new PhoneNumbersClient(connectionString);

البحث عن تنسيق رقم الهاتف

للبحث عن معلومات مشغل رقم الهاتف، اتصل searchOperatorInformation من PhoneNumbersClient.

let formattingResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ]);

استبدل <target-phone-number> برقم الهاتف الذي تبحث عنه، وعادة ما يكون رقما تريد إرسال رسالة إليه.

تحذير

قم بتوفير أرقام الهواتف بتنسيق E.164 القياسي الدولي، على سبيل المثال، +14255550123.

البحث عن معلومات عامل التشغيل عن رقم

للبحث عن معلومات مشغل رقم الهاتف، اتصل searchOperatorInformation من PhoneNumbersClient، ومرر true للخيار includeAdditionalOperatorDetails .

let searchResults = await phoneNumbersClient.searchOperatorInformation([ "<target-phone-number>" ], { "includeAdditionalOperatorDetails": true });

تحذير

سيؤدي استخدام هذه الوظيفة إلى فرض رسوم على حسابك.

استخدام معلومات عامل التشغيل

يمكنك الآن استخدام معلومات عامل التشغيل. للحصول على دليل التشغيل السريع هذا، يمكننا طباعة بعض التفاصيل إلى وحدة التحكم.

أولا، يمكننا طباعة تفاصيل حول تنسيق الأرقام.

let formatInfo = formattingResults.values[0];
console.log(formatInfo.phoneNumber + " is formatted " + formatInfo.internationalFormat + " internationally, and " + formatInfo.nationalFormat + " nationally");

بعد ذلك، يمكننا طباعة تفاصيل حول رقم الهاتف وعامل التشغيل.

let operatorInfo = searchResults.values[0];
console.log(operatorInfo.phoneNumber + " is a " + (operatorInfo.numberType ? operatorInfo.numberType : "unknown") + " number, operated in "
    + operatorInfo.isoCountryCode + " by " + (operatorInfo.operatorDetails.name ? operatorInfo.operatorDetails.name : "an unknown operator"));

يمكنك أيضا استخدام معلومات عامل التشغيل لتحديد ما إذا كنت تريد إرسال رسالة نصية قصيرة. لمزيد من المعلومات حول إرسال رسالة نصية قصيرة، راجع التشغيل السريع لرسائل SMS.

تشغيل التعليمات البرمجية

قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام node الأمر .

node number-lookup-quickstart.js

التعليمة البرمجية العينة

يمكنك تنزيل نموذج التطبيق من GitHub).

ابدأ باستخدام مكتبة عميل الهاتف Numbers ل C# للبحث عن معلومات المشغل لأرقام الهواتف، والتي يمكن استخدامها لتحديد ما إذا كان الاتصال برقم الهاتف هذا وكيفية الاتصال به. اتبع هذه الخطوات لتثبيت الحزمة والبحث عن معلومات المشغل حول رقم هاتف.

إشعار

ابحث عن رمز بدء التشغيل السريع هذا في GitHub

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
أحدث إصدار من مكتبة عميل .NET Core لنظام التشغيل الخاص بك.
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد Communication Services

التحقق من المتطلبات الأساسية

في النافذة الطرفية أو الأمر، تشغيل dotnet الأمر للتحقق من تثبيت NET SDK.

الإعداد

لإعداد بيئة لإرسال استعلامات البحث، اتبع الخطوات الواردة في الأقسام التالية.

إنشاء تطبيق C# جديد

في نافذة طرفية أو نافذة أوامر، قم بتشغيل dotnet new الأمر لإنشاء تطبيق وحدة تحكم جديد بالاسم NumberLookupQuickstart. يُنشئ هذا الأمر مشروع "مرحباً بالعالم" C# بسيطاً مع مصدر ملف واحد، Program.cs.

dotnet new console -o NumberLookupQuickstart

قم بتغيير الدليل الخاص بك إلى مجلد التطبيق الذي تم إنشاؤه حديثًا، واستخدم الأمر dotnet build للتحويل البرمجي لتطبيقك.

cd NumberLookupQuickstart
dotnet build

الاتصال إلى موجز حزمة التطوير

يتم نشر إصدار المعاينة العامة من SDK إلى موجز حزمة التطوير. يمكنك إضافة موجز التطوير باستخدام NuGet CLI، الذي يضيفه إلى ملف NuGet.Config.

nuget sources add -Name "Azure SDK for .NET Dev Feed" -Source "https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-net/nuget/v3/index.json"

يمكن العثور على معلومات أكثر تفصيلا وخيارات أخرى للاتصال بموجز التطوير في الدليل المساهم.

تثبيت الحزمة

أثناء الاستمرار في دليل التطبيق، قم بتثبيت مكتبة عميل Azure Communication Services الهاتف Numbers لحزمة .NET باستخدام الأمر التالي.

dotnet add package Azure.Communication.PhoneNumbers --version 1.3.0-beta.5

أضف توجيه using إلى أعلى Program.cs لتضمين مساحة اسم Azure.Communication.

using System;
using System.Threading.Tasks;
using Azure.Communication.PhoneNumbers;

تحديث Main توقيع الدالة ليكون متزامناً.

internal class Program
{
    static async Task Main(string[] args)
    {
        ...
    }
}

أمثلة على التعليمات البرمجية

مصادقة العميل

يمكن مصادقة عملاء الهاتف Number باستخدام سلسلة الاتصال الحصول عليها من مورد Azure Communication Services في مدخل Microsoft Azure. COMMUNICATION_SERVICES_CONNECTION_STRING يوصى باستخدام متغير بيئة لتجنب وضع سلسلة الاتصال في نص عادي داخل التعليمات البرمجية الخاصة بك. تعرف على كيفية إدارة سلسلة اتصال الموارد خاصتك.

// This code retrieves your connection string from an environment variable.
string? connectionString = Environment.GetEnvironmentVariable("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient client = new PhoneNumbersClient(connectionString, new PhoneNumbersClientOptions(PhoneNumbersClientOptions.ServiceVersion.V2024_03_01_Preview));

يمكن لعملاء الهاتف Number أيضا المصادقة باستخدام مصادقة Microsoft Entra. باستخدام هذا الخيار، AZURE_CLIENT_SECRETAZURE_CLIENT_IDيجب إعداد متغيرات البيئة و و AZURE_TENANT_ID للمصادقة.

// Get an endpoint to our Azure Communication Services resource.
Uri endpoint = new Uri("<endpoint_url>");
TokenCredential tokenCredential = new DefaultAzureCredential();
client = new PhoneNumbersClient(endpoint, tokenCredential);

البحث عن تنسيق رقم الهاتف

للبحث عن التنسيق الوطني والدولي لرقم، اتصل SearchOperatorInformationAsync من PhoneNumbersClient.

OperatorInformationResult formattingResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" });

استبدل <target-phone-number> برقم الهاتف الذي تبحث عنه، وعادة ما يكون رقما تريد إرسال رسالة إليه.

تحذير

قم بتوفير أرقام الهواتف بتنسيق E.164 القياسي الدولي، على سبيل المثال، +14255550123.

البحث عن معلومات عامل التشغيل عن رقم

للبحث عن معلومات مشغل رقم الهاتف، اتصل SearchOperatorInformationAsync من PhoneNumbersClient، ومرر true للخيار IncludeAdditionalOperatorDetails .

OperatorInformationResult searchResult = await client.SearchOperatorInformationAsync(new[] { "<target-phone-number>" }, new OperatorInformationOptions() { IncludeAdditionalOperatorDetails = true });

تحذير

سيؤدي استخدام هذه الوظيفة إلى فرض رسوم على حسابك.

استخدام معلومات عامل التشغيل

أولا، يمكننا طباعة تفاصيل حول تنسيق الأرقام.

OperatorInformation formattingInfo = formattingResult.Values[0];
Console.WriteLine($"{formattingInfo.PhoneNumber} is formatted {formattingInfo.InternationalFormat} internationally, and {formattingInfo.NationalFormat} nationally");

بعد ذلك، يمكننا طباعة تفاصيل حول رقم الهاتف وعامل التشغيل.

OperatorInformation operatorInformation = searchResult.Values[0];
Console.WriteLine($"{operatorInformation.PhoneNumber} is a {operatorInformation.NumberType ?? "unknown"} number, operated in {operatorInformation.IsoCountryCode} by {operatorInformation.OperatorDetails.Name ?? "an unknown operator"}");

تشغيل التعليمات البرمجية

قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام dotnet run الأمر .

dotnet run --interactive

التعليمة البرمجية العينة

يمكنك تنزيل التطبيق العينة من GitHub.

ابدأ باستخدام مكتبة عميل الهاتف Numbers ل Java للبحث عن معلومات المشغل لأرقام الهواتف، والتي يمكن استخدامها لتحديد ما إذا كان سيتم الاتصال برقم الهاتف هذا وكيفية الاتصال به. اتبع هذه الخطوات لتثبيت الحزمة والبحث عن معلومات المشغل حول رقم هاتف.

إشعار

ابحث عن رمز بدء التشغيل السريع هذا في GitHub

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
Java Development Kit (SDK) الإصدار 8 أو أحدث.
Apache Maven.
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد Communication Services

التحقق من المتطلبات الأساسية

في نافذة طرفية أو نافذة أوامر، قم بتشغيل mvn -v الأمر للتحقق من تثبيت Maven.

الإعداد

لإعداد بيئة لإرسال استعلامات البحث، اتبع الخطوات الواردة في الأقسام التالية.

إنشاء تطبيق Java جديد

في نافذة طرفية أو نافذة أوامر، انتقل إلى الدليل حيث تريد إنشاء تطبيق Java الخاص بك. قم بتشغيل الأمر التالي لإنشاء مشروع Java من قالب maven-archetype-quickstart.

mvn archetype:generate -DgroupId=com.communication.lookup.quickstart -DartifactId=communication-lookup-quickstart -DarchetypeArtifactId=maven-archetype-quickstart -DarchetypeVersion=1.4 -DinteractiveMode=false

تنشئ المهمة "إنشاء" دليلا بنفس اسم artifactId. ضمن هذا الدليل، يحتوي الدليل src/main/java على التعليمة البرمجية المصدر للمشروع، بينما يحتوي src/test/java directory على مصدر الاختبار، أما الملف pom.xml فهو نموذج كائن المشروع أو POM.

الاتصال إلى موجز حزمة التطوير

يتم نشر إصدار المعاينة العامة من SDK إلى موجز حزمة التطوير. للاتصال بموجز التطوير، افتح ملف pom.xml في محرر النص وأضف مستودع التطوير إلى كل من pom.xml <repositories> والمقاطع <distributionManagement> التي يمكنك إضافتها إذا لم تكن موجودة بالفعل.

<repository>
  <id>azure-sdk-for-java</id>
  <url>https://pkgs.dev.azure.com/azure-sdk/public/_packaging/azure-sdk-for-java/maven/v1</url>
  <releases>
    <enabled>true</enabled>
  </releases>
  <snapshots>
    <enabled>true</enabled>
  </snapshots>
</repository>

قد تحتاج إلى إضافة الملف أو تحريره settings.xml في ${user.home}/.m2

<server>
  <id>azure-sdk-for-java</id>
  <username>azure-sdk</username>
  <password>[PERSONAL_ACCESS_TOKEN]</password>
</server>

يمكنك إنشاء رمز وصول شخصي مع نطاقات قراءة وكتابة التعبئة والتغليف ولصقه في العلامة<password>.

يمكن العثور على مزيد من المعلومات التفصيلية والخيارات الأخرى للاتصال بموجز التطوير هنا.

تثبيت الحزمة

أضف عناصر التبعية التالية إلى مجموعة التبعيات في ملف pom.xml .

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-common</artifactId>
    <version>1.0.0</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-communication-phonenumbers</artifactId>
    <version>1.2.0-beta.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-identity</artifactId>
    <version>1.2.3</version>
  </dependency>

  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core</artifactId>
    <version>1.41.0</version>
  </dependency>
</dependencies>

تحقق من properties القسم للتأكد من أن مشروعك يستهدف الإصدار 1.8 من Maven أو أعلى.

<properties>
  <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
  <maven.compiler.source>1.8</maven.compiler.source>
  <maven.compiler.target>1.8</maven.compiler.target>
</properties>

أمثلة على التعليمات البرمجية

إعداد إطار عمل التطبيق

من دليل المشروع:

انتقل إلى دليل /src/main/java/com/communication/lookup/quickstart
فتح الملف App.java في المحرر الخاص بك
استبدال System.out.println("Hello world!"); العبارة
أضف توجيهات import

استخدم الكود التالي للبدء:

package com.communication.lookup.quickstart;

import com.azure.communication.phonenumbers.*;
import com.azure.communication.phonenumbers.models.*;
import com.azure.core.http.rest.*;
import com.azure.core.util.Context;
import com.azure.identity.*;
import java.io.*;
import java.util.ArrayList;

public class App
{
    public static void main( String[] args ) throws IOException
    {
        System.out.println("Azure Communication Services - Number Lookup Quickstart");
        // Quickstart code goes here
    }
}

مصادقة العميل

يمكن مصادقة العميل باستخدام سلسلة الاتصال المكتسبة من مورد Azure Communication Services في مدخل Microsoft Azure. COMMUNICATION_SERVICES_CONNECTION_STRING يوصى باستخدام متغير بيئة لتجنب وضع سلسلة الاتصال في نص عادي داخل التعليمات البرمجية الخاصة بك. تعرف على كيفية إدارة سلسلة اتصال الموارد خاصتك.

// This code retrieves your connection string from an environment variable
String connectionString = System.getenv("COMMUNICATION_SERVICES_CONNECTION_STRING");

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .connectionString(connectionString)
    .buildClient();

بدلا من ذلك، يمكنك المصادقة باستخدام مصادقة Microsoft Entra. DefaultAzureCredentialBuilder يعد استخدام أسهل طريقة لبدء استخدام معرف Microsoft Entra. يمكنك الحصول على اسم المورد الخاص بك من مورد Azure Communication Services في مدخل Microsoft Azure.

// You can find your resource name from your resource in the Azure portal
String endpoint = "https://<RESOURCE_NAME>.communication.azure.com";

PhoneNumbersClient phoneNumberClient = new PhoneNumbersClientBuilder()
    .endpoint(endpoint)
    .credential(new DefaultAzureCredentialBuilder().build())
    .buildClient();

البحث عن تنسيق رقم الهاتف

للبحث عن التنسيق الوطني والدولي لرقم، اتصل searchOperatorInformation من PhoneNumbersClient.

ArrayList<String> phoneNumbers = new ArrayList<String>();
phoneNumbers.add("<target-phone-number>");

// Use the free number lookup functionality to get number formatting information
OperatorInformationResult formattingResult = phoneNumberClient.searchOperatorInformation(phoneNumbers);
OperatorInformation formattingInfo = formattingResult.getValues().get(0);

استبدل <target-phone-number> برقم الهاتف الذي تبحث عنه، وعادة ما يكون رقما تريد إرسال رسالة إليه.

تحذير

قم بتوفير أرقام الهواتف بتنسيق E.164 القياسي الدولي، على سبيل المثال، +14255550123.

البحث عن معلومات عامل التشغيل عن رقم

للبحث عن معلومات مشغل رقم الهاتف، اتصل searchOperatorInformationWithResponse من PhoneNumbersClient، ومرر true للخيار IncludeAdditionalOperatorDetails .

OperatorInformationOptions options = new OperatorInformationOptions();
options.setIncludeAdditionalOperatorDetails(true);
Response<OperatorInformationResult> result = phoneNumberClient.searchOperatorInformationWithResponse(phoneNumbers, options, Context.NONE);
OperatorInformation operatorInfo = result.getValue().getValues().get(0);

تحذير

سيؤدي استخدام هذه الوظيفة إلى فرض رسوم على حسابك.

استخدام معلومات عامل التشغيل

أولا، يمكننا طباعة تفاصيل حول تنسيق الأرقام.

System.out.println(formattingInfo.getPhoneNumber() + " is formatted "
    + formattingInfo.getInternationalFormat() + " internationally, and "
    + formattingInfo.getNationalFormat() + " nationally");

بعد ذلك، يمكننا طباعة تفاصيل حول رقم الهاتف وعامل التشغيل.

String numberType = operatorInfo.getNumberType() == null ? "unknown" : operatorInfo.getNumberType().toString();
String operatorName = "an unknown operator";
if (operatorInfo.getOperatorDetails()!= null && operatorInfo.getOperatorDetails().getName() != null)
{
    operatorName = operatorInfo.getOperatorDetails().getName();
}
System.out.println(operatorInfo.getPhoneNumber() + " is a " + numberType + " number, operated in "
    + operatorInfo.getIsoCountryCode() + " by " + operatorName);

تشغيل التعليمات البرمجية

قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام الأوامر التالية: انتقل إلى الدليل الذي يحتوي على ملف pom.xml وقم بتجميع المشروع.

mvn compile

ثم قم ببناء الحزمة.

mvn package

لتنفيذ التطبيق، استخدم mvn الأمر .

mvn exec:java -D"exec.mainClass"="com.communication.lookup.quickstart.App" -D"exec.cleanupDaemonThreads"="false"

التعليمة البرمجية العينة

يمكنك تنزيل التطبيق العينة من GitHub.

ابدأ باستخدام مكتبة عميل أرقام الهاتف ل Python للبحث عن معلومات المشغل لأرقام الهواتف، والتي يمكن استخدامها لتحديد ما إذا كان الاتصال برقم الهاتف هذا وكيفية الاتصال به. اتبع هذه الخطوات لتثبيت الحزمة والبحث عن معلومات المشغل حول رقم هاتف.

إشعار

ابحث عن رمز بدء التشغيل السريع هذا في GitHub

المتطلبات الأساسية

حساب Azure مع اشتراك نشط. أنشئ حساباً مجاناً.
Python 3.7+.
مورد "خدمات الاتصال" النشطة وسلسلة الاتصال. إنشاء مورد Communication Services

التحقق من المتطلبات الأساسية

في نافذة طرفية أو نافذة أوامر، قم بتشغيل python --version الأمر للتحقق من تثبيت Python.

الإعداد

لإعداد بيئة لإرسال استعلامات البحث، اتبع الخطوات الواردة في الأقسام التالية.

إنشاء تطبيق Python جديد

في نافذة طرفية أو نافذة أوامر، أنشئ دليلا جديدا لتطبيقك وانتقل إليه.

mkdir number-lookup-quickstart && cd number-lookup-quickstart

استخدم محرر نص لإنشاء ملف يسمى number_lookup_sample.py في الدليل الجذر للمشروع وإضافة التعليمات البرمجية التالية. تتم إضافة التعليمات البرمجية للتشغيل السريع المتبقية في الأقسام التالية.

import os
from azure.communication.phonenumbers import PhoneNumbersClient

try:
   print('Azure Communication Services - Number Lookup Quickstart')
   # Quickstart code goes here
except Exception as ex:
   print('Exception:')
   print(ex)

تثبيت الحزمة

أثناء الاستمرار في دليل التطبيق، قم بتثبيت مكتبة عميل Azure Communication Services الهاتف Numbers لحزمة Python باستخدام pip install الأمر .

pip install azure-communication-phonenumbers==1.2.0b2

أمثلة على التعليمات البرمجية

مصادقة العميل

# This code retrieves your connection string from an environment variable
connection_string = os.getenv('COMMUNICATION_SERVICES_CONNECTION_STRING')
try:
    phone_numbers_client = PhoneNumbersClient.from_connection_string(connection_string)
except Exception as ex:
    print('Exception:')
    print(ex)

بدلا من ذلك، يمكن مصادقة العميل باستخدام مصادقة Microsoft Entra. DefaultAzureCredential استخدام الكائن هو أسهل طريقة لبدء استخدام معرف Microsoft Entra ويمكنك تثبيته باستخدام pip install الأمر .

pip install azure-identity

يتطلب إنشاء كائن DefaultAzureCredential أن يكون لديك AZURE_CLIENT_ID، AZURE_CLIENT_SECRET، وتعيينه AZURE_TENANT_ID بالفعل كمتغيرات بيئة بقيمها المقابلة من تطبيق Microsoft Entra المسجل.

للحصول على زيادة في كيفية الحصول على متغيرات البيئة هذه، يمكنك معرفة كيفية إعداد كيانات الخدمة من CLI.

بمجرد تثبيت المكتبة azure-identity ، يمكنك متابعة مصادقة العميل.

from azure.identity import DefaultAzureCredential

# You can find your endpoint from your resource in the Azure portal
endpoint = 'https://<RESOURCE_NAME>.communication.azure.com'
try:
    credential = DefaultAzureCredential()
    phone_numbers_client = PhoneNumbersClient(endpoint, credential)
except Exception as ex:
    print('Exception:')
    print(ex)

البحث عن تنسيق رقم الهاتف

للبحث عن التنسيق الوطني والدولي لرقم، اتصل search_operator_information من PhoneNumbersClient.

formatting_results = phone_numbers_client.search_operator_information("<target-phone-number>")

استبدل <target-phone-number> برقم الهاتف الذي تبحث عنه، وعادة ما يكون رقما تريد إرسال رسالة إليه.

تحذير

قم بتوفير أرقام الهواتف بتنسيق E.164 القياسي الدولي، على سبيل المثال، +14255550123.

البحث عن معلومات عامل التشغيل عن رقم

للبحث عن معلومات مشغل رقم الهاتف، اتصل search_operator_information من PhoneNumbersClient، ومرر True للخيار include_additional_operator_details .

options = { "include_additional_operator_details": True }
operator_results = phone_numbers_client.search_operator_information("<target-phone-number>", options)

تحذير

سيؤدي استخدام هذه الوظيفة إلى فرض رسوم على حسابك.

استخدام معلومات عامل التشغيل

أولا، يمكننا طباعة تفاصيل حول تنسيق الأرقام.

formatting_info = formatting_results.values[0]
print(str.format("{0} is formatted {1} internationally, and {2} nationally", formatting_info.phone_number, formatting_info.international_format, formatting_info.national_format))

بعد ذلك، يمكننا طباعة تفاصيل حول رقم الهاتف وعامل التشغيل.

operator_information = operator_results.values[0]

number_type = operator_information.number_type if operator_information.number_type else "unknown"
if operator_information.operator_details is None or operator_information.operator_details.name is None:
    operator_name = "an unknown operator"
else:
    operator_name = operator_information.operator_details.name

print(str.format("{0} is a {1} number, operated in {2} by {3}", operator_information.phone_number, number_type, operator_information.iso_country_code, operator_name))

تشغيل التعليمات البرمجية

قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام python الأمر .

python number_lookup_sample.py

التعليمة البرمجية العينة

يمكنك تنزيل التطبيق العينة من GitHub.

استكشاف الأخطاء وإصلاحها

الأسئلة والمشكلات الشائعة:

قد لا تسري التغييرات على متغيرات البيئة في البرامج قيد التشغيل بالفعل. إذا لاحظت أن متغيرات البيئة الخاصة بك لا تعمل كما هو متوقع، فحاول إغلاق وإعادة فتح أي برامج تستخدمها لتشغيل التعليمات البرمجية وتحريرها.
تخضع البيانات التي يتم إرجاعها بواسطة نقطة النهاية هذه لمختلف القوانين واللوائح الدولية، وبالتالي فإن دقة النتائج تعتمد على عدة عوامل. تتضمن هذه العوامل ما إذا كان الرقم قد تم تصديره ورمز البلد وحالة الموافقة للمتصل. استنادا إلى هذه العوامل، قد لا تتوفر معلومات المشغل لبعض أرقام الهواتف أو قد تعكس المشغل الأصلي لرقم الهاتف، وليس المشغل الحالي.

الخطوات التالية

في هذا التشغيل السريع، قد تعلّمت كيفية:

البحث عن تنسيق الأرقام
البحث عن معلومات عامل التشغيل لرقم هاتف

مفهوم البحث عن الأرقام

عدة تطوير البرامج للبحث عن الأرقام

التشغيل السريع: البحث عن معلومات عامل التشغيل لرقم هاتف باستخدام Azure Communication Services

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Node.js جديد

تثبيت الحزمة

أمثلة على التعليمات البرمجية

مصادقة العميل

البحث عن تنسيق رقم الهاتف

البحث عن معلومات عامل التشغيل عن رقم

استخدام معلومات عامل التشغيل

تشغيل التعليمات البرمجية

التعليمة البرمجية العينة

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق C# جديد

الاتصال إلى موجز حزمة التطوير

تثبيت الحزمة

أمثلة على التعليمات البرمجية

مصادقة العميل

البحث عن تنسيق رقم الهاتف

البحث عن معلومات عامل التشغيل عن رقم

استخدام معلومات عامل التشغيل

تشغيل التعليمات البرمجية

التعليمة البرمجية العينة

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Java جديد

الاتصال إلى موجز حزمة التطوير

تثبيت الحزمة

أمثلة على التعليمات البرمجية

إعداد إطار عمل التطبيق

مصادقة العميل

البحث عن تنسيق رقم الهاتف

البحث عن معلومات عامل التشغيل عن رقم

استخدام معلومات عامل التشغيل

تشغيل التعليمات البرمجية

التعليمة البرمجية العينة

المتطلبات الأساسية

التحقق من المتطلبات الأساسية

الإعداد

إنشاء تطبيق Python جديد

تثبيت الحزمة

أمثلة على التعليمات البرمجية

مصادقة العميل

البحث عن تنسيق رقم الهاتف

البحث عن معلومات عامل التشغيل عن رقم

استخدام معلومات عامل التشغيل

تشغيل التعليمات البرمجية

التعليمة البرمجية العينة

استكشاف الأخطاء وإصلاحها

الخطوات التالية

الموارد الإضافية