التشغيل السريع: البحث عن معلومات عامل التشغيل لرقم هاتف باستخدام Azure Communication Services
هام
هذه الميزة من 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_SECRET
AZURE_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"}");
يمكنك أيضا استخدام معلومات عامل التشغيل لتحديد ما إذا كنت تريد إرسال رسالة نصية قصيرة. لمزيد من المعلومات حول إرسال رسالة نصية قصيرة، راجع التشغيل السريع لرسائل SMS.
تشغيل التعليمات البرمجية
قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام 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);
يمكنك أيضا استخدام معلومات عامل التشغيل لتحديد ما إذا كنت تريد إرسال رسالة نصية قصيرة. لمزيد من المعلومات حول إرسال رسالة نصية قصيرة، راجع التشغيل السريع لرسائل SMS.
تشغيل التعليمات البرمجية
قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام الأوامر التالية: انتقل إلى الدليل الذي يحتوي على ملف 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
أمثلة على التعليمات البرمجية
مصادقة العميل
يمكن مصادقة العميل باستخدام سلسلة الاتصال المكتسبة من مورد Azure Communication Services في مدخل Microsoft Azure. COMMUNICATION_SERVICES_CONNECTION_STRING
يوصى باستخدام متغير بيئة لتجنب وضع سلسلة الاتصال في نص عادي داخل التعليمات البرمجية الخاصة بك. تعرف على كيفية إدارة سلسلة اتصال الموارد خاصتك.
# 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))
يمكنك أيضا استخدام معلومات عامل التشغيل لتحديد ما إذا كنت تريد إرسال رسالة نصية قصيرة. لمزيد من المعلومات حول إرسال رسالة نصية قصيرة، راجع التشغيل السريع لرسائل SMS.
تشغيل التعليمات البرمجية
قم بتشغيل التطبيق من المحطة الطرفية أو نافذة الأوامر باستخدام python
الأمر .
python number_lookup_sample.py
التعليمة البرمجية العينة
يمكنك تنزيل التطبيق العينة من GitHub.
استكشاف الأخطاء وإصلاحها
الأسئلة والمشكلات الشائعة:
- قد لا تسري التغييرات على متغيرات البيئة في البرامج قيد التشغيل بالفعل. إذا لاحظت أن متغيرات البيئة الخاصة بك لا تعمل كما هو متوقع، فحاول إغلاق وإعادة فتح أي برامج تستخدمها لتشغيل التعليمات البرمجية وتحريرها.
- تخضع البيانات التي يتم إرجاعها بواسطة نقطة النهاية هذه لمختلف القوانين واللوائح الدولية، وبالتالي فإن دقة النتائج تعتمد على عدة عوامل. تتضمن هذه العوامل ما إذا كان الرقم قد تم تصديره ورمز البلد وحالة الموافقة للمتصل. استنادا إلى هذه العوامل، قد لا تتوفر معلومات المشغل لبعض أرقام الهواتف أو قد تعكس المشغل الأصلي لرقم الهاتف، وليس المشغل الحالي.
الخطوات التالية
في هذا التشغيل السريع، قد تعلّمت كيفية:
- البحث عن تنسيق الأرقام
- البحث عن معلومات عامل التشغيل لرقم هاتف